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开发 环境 准备 


本 章 主 要 介绍 Spring MVC 和 MyBatis 的 环境 准备 ， 包 括 JDK 安装 、Intelli IDEA 安装 、 
Tomcat 安装 和 配置 、Maven 安装 以 及 MySQL 数据 库 安装 等 内 容 。 


1.1 JDK 安 


潭 


JDK( 全 称 : Java Development Kit) 是 Java 语言 的 软件 开发 工具 包 ， 由 SUN 公司 提供 。JDK 
是 整个 Java 开发 的 核心 ， 它 包含 了 Java 的 运行 环境 (JVM + Java 系统 类 库 ) 和 Java 工具 ， 所 
有 Java 程序 的 编写 都 依赖 于 它 。 

下 面 介 绍 JDK 的 安装 。 

JDK 建议 使 用 1.8 及 以 上 的 版 本 ， 其 官方 下 载 路 径 : http://www.oracle.com/technetwork/java/ 
javase/downloads/jdk8-downloads-2133151.html。 读 者 可 以 根据 自己 的 Windows 操作 系统 的 配置 选 
择 合适 的 JDK 1.8 安装 包 ， 这 里 就 不 过 多 描述 。 

软件 下 载 完成 之 后 ， 双 击 下 载 软件 ， 出 现 安装 界面 ， 如 图 1-1 所 示 。 一 路 单 击 【下 一 步 】 
按钮 ， 即 可 完成 安装 。 这 里 笔者 把 JDK 安装 在 路 径 C:\Program Files\Java\jdk1.8.0_77 下 。 

安装 完成 后 ， 需 要 配置 环境 变量 JAVA HOME， 具 体 步 又 如 下 : 


人 .01 在 电脑 桌面 上 ， 右 击 【 我 的 电脑 】 一 【属性 】 一 【高 级 系统 设置 】 一 【环境 变量 】 
一 【系统 变量 (S)】 一 【新 建 ]， 出 现 新 建 环 境 变量 的 窗口 ， 如 图 1-2 所 示 。 
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欢迎 使 用 Java SE 开发 工具 包 8 Update 77 的 安装 向 导 


本 向 导 将 指导 您 完成 Java SE 开发 工具 包 8 Update 77 的 安装 过 程 。 


Java Mission Control 分 析 和 诊断 工具 套件 现在 作为 ]DK 的 一 部 分 提供 。 


i 


图 1-1 JDK 安装 界面 


握 输 系统 变量 x 


| 变量 名 (N): JAVA_HOME 

二 

变量 值 V); 

| 

| 浏览 目录 (D).. 浏览 文件 (F).… 碳 定 到 消 


图 1-2 ”新建 环境 变量 窗口 
2 在 【变量 名 】 和 【变量 值 】 文 本 框 中 分 别 填 入 JAVA_HOME 和 C:\Program Files\Java\ 


We 77， 单 击 【 确 定 】 按 钮 。 
人 03 JAVA_HOME 配置 好 之 后 , 将 %JAVA_HOME%\bin 加 入 到 【系统 变量 ] 的 path 中 。 
eng 打开 命令 行 窗口 ， 输 入 命令 java -version。 出 现 如 图 1-3 所 示 的 提示 ， 即 表示 安 


中 命令 提示 符 日 x 


图 1-3 ”安装 成 功 命令 行 窗口 
JDK 安装 路 径 最 好 不 要 出 现 中 文 ， 否 则 会 出 现 意 想不到 的 错误 。 
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1.2 Intellij IDEA 安装 


IDEA 全 称 Intellij IDEA， 是 Java 语言 开发 的 集成 环境 ，Intellij 在 业界 被 公认 为 最 好 的 Java 
开发 工具 之 一 ， 尤 其 在 智能 代码 助手 、 代 码 自动 提示 、 重 构 、J2EE 支持 、 各 类 版 本 工具 (Git、 
Svn、Github 等 ) 、JUnit、CVS 整合 、 代 码 分 析 、 创 新 的 GUI 设计 等 方面 的 功能 可 以 说 是 超常 
的 。IDEA 是 JetBrains 公司 的 产品 ， 这 家 公司 总 部 位 于 捷克 共和 国 的 首都 布拉格 ， 开 发 人 员 以 
严谨 著称 的 东欧 程序 员 为 主 。 它 的 旗舰 版 本 还 支持 HTML、CSS、PHP、MySQL、Python 等 。 
免费 版 只 支持 Java 等 少数 语言 。 
如 果 你 还 在 使 用 Eclipse 或 者 MyEclipse 等 开发 工具 进行 代码 开发 ， 强 烈 建议 读者 切 
换 到 Intellij IDEA 开发 工具 。 目 前 所 有 大 型 的 互联 网 公司 ， 比 如 百度 、 腾 讯 、 阿 里 、 

注 意 美国 等 ， 都 是 使 用 Intellij IDEA 进行 项 目 开发 的 ，IDEA 是 目前 的 主流 开发 工具 ， 会 
极 大 地 提高 你 的 开发 效率 。 


在 Intellij IDEA 的 官方 网 站 http://www.jetbrains.com/idea/ 可 以 免费 下 载 IDEA。 下 载 完 IDEA 
后 ， 运 行 安装 程序 ， 按 提示 安装 即 可 。 本 书 使 用 Intellij IDEA 2016.2 版 本 ， 当 然 读者 也 可 以 使 
用 其 他 版 本 的 IDEA， 只 要 版 本 不 要 过 低 即 可 。 安 装 成 功 之 后 ， 软 件 界 面 如 图 1-4 bn 


| | pringmve-rnybatis-book (E: A pring me mae bo inte) DEA 
| ee Analyze Refactor Bu DO VOS Window 对 er 
| 许 ww 


WW External Libraries 


Le ote Bosmem 


全 ， ol plugin is not activated yet yowu Can enter key Or yoo: can Go here (4mingtes ago) it: masters 


1-4 ”Intellij IDEA 软件 窗口 
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1.3 Tomcat 的 安装 与 配置 


Tomcat 服务 器 是 一 个 免费 的 开放 源 代码 的 Web 应 用 服务 器 ， 属 于 轻 量 级 应 用 服务 器 。 因 
为 Tomcat 技术 先进 、 性 能 稳定 ， 而 且 免 费 ， 因 而 深 受 Java 爱好 者 的 喜爱 并 得 到 了 部 分 软件 开 
发 商 的 认可 ， 成 为 目前 比较 流行 的 Web 应 用 服务 器 。 


1.3.1 Tomcat 的 下 载 


本 书 使 用 Tomcat 8.0 进行 讲解 ， 可 到 官网 https://tomcat.apache.org/download-80.cgi 进行 下 
载 ， 下 载 完 成 之 后 解压 到 D 盘 ， 并 将 解压 后 的 文件 夹 命 名 为 tomcat8。 具 体 如 图 1-5 所 示 。 


本 地 碎 盘 (D:) 》tomcat8 


bin 
conf 
所 
logs 


temp 
webapps 
work 
LCENSE 
$ NOTICE 
} RELEASE-NOTES 
E RUNNING.txt 


图 1-5 Tomcat 解压 目录 


1.3.2 Intellij IDEA 配置 Tomcat 


在 Intellij IDEA 中 配置 Tomcat， 具 体 步 又 如 下 : 


01 在 IDEA 开发 菜单 栏 中 ， 选 择 【run】 一 【Edit Configurations】， 在 弹出 的 窗口 中 
这 在 【Defaults】 一 【Tomcat Server】 一 【Local]， 在 【Application server】 中 选择 Tomcat 的 安 

装 路 径 ， 在 【JRE】 中 选择 JDK 的 安装 路 径 ， 最 后 单 击 【Apply】 一 【OK]】 确认 ， 具 体 如 图 1-6 
所 示 。 


富 守 02 步骤 一 只 是 配置 一 个 Defaults 默认 Tomcat 模板 ， 现 在 我 们 单 击 【+】 加 号 按钮 一 
【Tomcat Server】 一 【Local】]， 在 弹出 的 界面 中 输入 Name 为 tomcat8， 其 他 信息 会 从 默认 模板 
中 获取 到 ， 具 体 如 图 1-7 和 图 1-8 所 示 。 
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e 十 button to create a new configuration based on default settings 
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党 TestNG Test Discovery 
Tomcat Server 

汰 XsLT 

30 items more (irrelevant) 


vr urnguruwr 
> 贡 Geronimo Server 


区 eGlassFish Server er 
起 Google App Engine Depioyr Confirm rerun with process termination 


总 Google AppEngine Dev Ser 


| A Temporary configurations Jimit: ， 5 


图 1-7 创建 tomcat 配置 


非 卖 品 ， 仅 供 非 商业 用 途 或 交流 学 习 使 用 
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辐 RurVDebug Configurations x 
| | Nanwe: | tomecata a OD share 


就 Tomcat Server Serven Depioyment Logs Code Coverage Startip/Connection 


| 驴 torncat8 
» 3 Defaults Application server: Tomcat 6.0.332 如 Configure… 
Open browser 
After launch 和 @ Default "| 门 with lavaScript debugger 


http://localhost:8080/ 


YM options: 及 
On ‘Update' actior Restart server | Show dialog 
On frame deactivation: Do nothing + | 


RE tf + 
Tomcat Server Settirgs 


HTTP port: 8080 站 Deploy applications configured in Tomcat instance 
HTTPs port: preserve sessions across restarts and redeploys 
JMX PorE 1099 

ASP port: 


» Betore launecit Make, Bulld Artifacts, AcEvate tool Wittfew 
Ganel | [ Appy | [ -Hep 
图 1-8 修改 tomcat 名 称 
03 在 图 1-8 中 ， 单 击 【Apply】 一 【OK】。 至 此 ，Intellij IDEA 配置 Tomcat 大 功 告 成 。 


1.4 Maven 的 安装 和 配置 


Apache Maven 是 目前 流行 的 项 目 管理 和 构建 自动 化 工具 。Maven 项 目 对 象 模 型 (POM) ， 
可 以 通过 一 小 段 描述 信息 来 管理 项 目的 构建 、 报 告 和 文档 的 软件 项 目 管理 工具 。Maven 除了 以 
程序 构建 能 力 为 特色 之 外 ， 还 提供 高 级 项 目 管理 工具 。 由 于 Maven 的 默认 构建 规则 有 较 高 的 可 
重用 性 ， 所 以 常常 用 两 三 行 Maven 脚本 就 可 以 构建 简单 的 项 目 。 

下 面 介绍 Maven 的 安装 和 配置 。 

虽然 Intellij IDEA 已 经 包含 了 Maven 插件 ， 但 是 笔者 还 是 希望 读者 在 工作 中 能 够 安装 自己 
的 Maven 插件 ， 方 便 以 后 项 目 配置 需要 。 可 以 通过 Maven 的 官网 http://maven.apache.org/ 
download.cgi 下 载 最 新 版 的 Maven， 本 书 的 Maven 版 本 为 apache-maven-3.5.0。 

Maven 下 载 完 后 解压 缩 即 可 。 例 如 ， 解 压 到 D: 盘 上 ， 然 后 将 Maven 的 安装 路 径 
D:apache-maven-3.5.0\bin 加 入 到 Window 的 环境 变量 path 中 。 安 装 完成 后 ， 在 命令 行 窗口 执行 
命令 : mvn -v， 如 果 输 出 如 图 1-9 所 示 的 页 面 ， 表 示 Maven 安装 成 功 。 


非 卖 品 ， 仅 供 非 商业 用 途 或 交流 学 习 使 上 
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图 1-9 Maven 安装 成 功 命令 行 窗口 
接 下 来 ， 我 们 在 Intellij IDEA 下 配置 Maven， 有 具体 步骤 如 下 : 
01 在 Maven 安装 目录 ， 即 D:\apache-maven-3.5.0 下 新 建文 件 夹 repository， 用 来 作为 


02 在 Intellij IDEA 界面 中 ， 选 择 【File】 一 【Settings】]， 在 出 现 的 窗口 中 找到 Maven 
选项 ， 分 别 把 【Maven home directory】 【User settings file】] 、[【Local repository】， 设 置 为 我 们 自 
己 Maven 的 相关 目录 ， 如 图 1-10 所 示 。 


i 国 Settings 
Maven Build, Execution, Deployment » Build Tools ， Maven + Reset | 
| 
Appenrance & Behavior UL Work ofline | 


NoicAtiOns 
Use plugin registry 
Keymap 
Editor 如 Execute godls recursmvely 


站 Print exception stack traces 


站 Always update snapshots 


Liv. nplates 
> Output levet: info 民 | 
Plugins | 
Sulld Endcution Daployinant Checksum policy; No Globalpolicy 加 
Build Fools Multiproject build foil policy: . Befault 
plogin update policy: Defoult ignored by Maven 3+ | 
porting i 
ignored files Threads tT ocan ! | 
Runner Maven home directory; Dspache-maven-3.5,0 | > | 
Running Tests (Version: 3.5.0) 
Repositories User settings file- DAMapache-maven-3.5.0\confWwettings xml B23 Override | 
Other Settings py | 
Local repository: § Dapakhe .maven 3.5. 0Vepository Override 
Maver Heiper 区 ” 
| 
{ 
| 
| 


[ok 3 Cancel Apply Help 


图 1-10 Maven 设置 窗口 
03 设置 完成 后 ， 单 击 【Apply】 一 【OK].。 至 此 ，Maven 在 Intellij IDEA 的 配置 完成 。 


之 所 以 把 Maven 默认 仓库 ( C:\$ {user.home}\.m2\respository ) 的 路 径 改 为 我 们 自己 的 
目录 ( D:\apache-maven-3.5.0\repository )， 是 因为 respository 仓库 到 时 候 会 存放 很 多 
注 意 。 的 jar 包 ， 放 在 C 盘 影 响 电脑 的 性 能 ， 所 以 才 会 修改 默认 仓库 的 位 置 .。 
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共 非 商业 用 途 或 交流 学 习 使 | 
1.5 ”MySQL 数据 库 的 安装 


MySQL 是 目前 项 目 中 运用 广泛 的 关系 型 数据 库 ， 无 论 在 什么 样 的 公司 ， 都 运用 甚 广 。 
MySQL 所 使 用 的 SQL 语言 是 用 于 访问 数据 库 的 最 常用 的 标准 化 语言 。MySQL 软件 由 于 体积 
小 、 速 度 快 、 总 体 拥有 成 本 低 ， 尤 其 是 开发 源码 这 一 特点 ， 一 般 中 小 型 网 站 的 开发 痢 
MySQL 作为 网 站 数据 库 。 

1.5.1 MySQL 的 安装 


了 选择 


downloads/mysql/ 下 载 MySQL 安装 软件 ， 并 按照 提示 一 步 一 步 安 装 即 可 。 如 果 你 的 电脑 已 经 安 
装 了 MySQL， 可 略 过 此 节 。 本 书 使 有 


MySQL 的 安装 很 简单 ， 安 装 方式 也 有 多 种 。 读 者 可 以 到 MySQL 的 官网 https://dev.mysql.com/ 


日 的 MySQL 版 本 为 5.7.17。 


安装 完成 之 后 ， 需 要 检验 MySQL 安装 是 否 成 功 。 具 体 步 又 如 下 : 
Files\MyS 


打开 命令 行 窗口 , 进入 MySQL 安装 目录 , 笔者 的 MySQL 安装 目录 是 C:\Program 
QL\IMySQL Server 5.7\bin。 
02 在 命令 行 窗口 中 输入 命令 mysql -uroot -p 和 密码 登陆 MySQL， 然 后 再 输入 命令 
status 出 现 如 图 1-11 所 示人 信息， 表示 安装 成 功 。 
mysaql ok -p 


rrent input 


statement. 


1-11 MySQL 安装 状态 


仅 供 非 商 业 


途 或 交流 学 习 使 


非 卖 品 ， 仪 供 非 商业 用 途 或 交流 学 习 使 用 
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1.5.2 Navicat for MySQL 客户 端 安 装 与 使 用 


Navicat for MySQL 是 连接 MySQL 数据 库 的 客户 端 工具 ， 通 过 使 用 该 客户 端 工具 ， 方 便 我 
们 对 数据 库 进 行 操作 ， 比 如 创建 数据 库 表 、 添 加 数据 等 。 如 果 读 者 已 经 安装 了 其 他 的 MySQL 
客户 端 ， 可 以 略 过 本 节 。 

Navicat for MySQL 的 安装 也 非常 简单 ， 可 以 到 网 上 下 载 安装 即 可 。 安 装 完成 之 后 ， 打 开 软 
件 ， 如 图 1-12 所 示 。 


| % Navicat for MySQL 三 口 x 
| 文件 ”前 看 ”收藏 天 ”工具 窗口 。 帮助 登录 
| : 号 一 rk RT | 
.oa /i [| 
| 连 妆 用 产 函数 事件 查询 备份 模型 | 
iv EB localhost 对 铺 电 | 
| information_schema 有 | 
mysql 打开 章 条 设计 可 记名 新建 栖 条“ 忆 测 除 次 询 | 
performance schema | 
sakila | 
| 
| 
| 
[SN 人 | 


图 1-12 Navicat for MySQL 界面 


可 以 通过 【查询 】 一 【新 建 查询 】， 在 弹出 的 窗口 中 编写 相关 的 SQL 语句 来 查询 数据 。 当 
然 还 有 很 多 的 操作 ， 可 以 自己 去 使 用 和 掌握 它 ， 这 里 就 不 一 一 描述 了 。 


仅 供 非 商 业 用 途 或 交流 学 习 使 用 


非 卖 品 ， 仅 供 非 商业 用 途 或 交流 学 习 使 用 


快速 搭建 第 一 个 SSM 项 目 


本 章 首先 简单 介绍 Spring、Spring MVC、MyBatis, 然后 讲解 如 何 一 步 一 步 快 速 搭建 第 一 个 
SSM 项 目 。 


2.1 SSM 简 述 


2.1.1 Spring 简 述 


Spring 开源 框架 是 一 个 轻 量 级 的 企业 级 开发 的 一 站 式 解决 方案 ， 是 为 了 解决 企业 应 用 程序 
开发 复杂 性 而 创建 的 。 基 于 Spring 可 以 解决 Java EE 开发 的 所 有 问题 。 

Spring 框架 是 一 个 分 层 架 构 ， 由 多 个 定义 良好 的 模块 组 成 ， 具 体 如 图 2-1 所 示 。 分 层 架 构 
允许 用 户 选 择 使 用 哪 一 个 组 件 ， 同 时 为 J2EE 应 用 程序 开发 提供 集成 的 框架 。 

1. 数据 访问 /集成 ‘Data Access/Integration) 


e ” JDBC 模块 : 提供 了 一 个 JBDC 的 样 例 模板 ， 使 用 这 些 模 板 能 消除 传统 元 长 的 JDBC 编 码 
和 必须 的 事务 控制 ， 而 且 还 能 享受 到 Spring 管 理事 务 的 好 处 。 

e ”ORM 模块 :提供 与 流行 的 “对 象 /关系 ”映射 框架 的 无 颖 集成 ， 包 括 Hibernate、JPA、 
Ibatis 等 。 而 且 可 以 使 用 Spring 事 务 管理 ， 无 需 额外 控制 事务 。 


仅 供 非 商 业 用 途 或 交流 学 习 使 用 


非 卖 品 ， 仅 供 非 商业 用 途 或 交流 学 习 使 有 
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OO Spring Framework Runtime 


DataAccesslintegration 奋 web 


JDBC ORM WebSocket Serviet 


OXM 


Portiet 
Transactions 


core Container 


Core Context 


图 2-1 Spring 模块 
OXM 模 块 : 提供 了 一 个 ObjecVXML 映 射 实现 ， 将 Java 对 象 映 射 成 XML 数据 ， 或 者 将 
XML 数据 映射 成 Java 对 象 ，ObjecVXML 上 映射 实现 包括 JAXB 、Castor、XMLBeans 和 
XStream 等 。 
JMS 模 块 : 提供 一 套 “ 消 息 生 产 者 、 消 息 消费 者 ”模板 ， 使 之 更 加 简单 地 使 用 JMS。 
JMS 用 于 在 两 个 应 用 程序 之 间 ， 或 分 布 式 系统 中 发 送 消息 ， 进 行 异 步 通信 。 
Transactions 模 块 : 该 模块 用 于 Spring 管理 事务 ， 只 要 是 Spring 管理 对 象 都 能 得 到 
Spring 管理 事务 的 好 处 ， 无 需 在 代码 中 进行 事务 控制 了 ， 而 且 支 持 编程 和 声明 性 的 事物 
管理 。 


. Web 


WebSocket 模 块 : 提供 WebSocket 功 能 。 

Servlet 模 块 : 提供 了 一 个 Spring MVC Web 框 架 实 现 。Spring MVC 框 架 提 供 了 基于 注解 

的 请 求 资源 注入 、 更 简单 的 数据 绑 定 、 数 据 验 证 等 及 一 套 非 常 易 用 的 JSP 标 签 ， 完 全 无 

颖 与 Spring 其 他 技术 协作 .。 

Web 模 块 : 提供 了 基础 的 Web 功 能 。 例 如 : 多 文件 上 传 、 集 成 IOC 容 器 、 远 程 过 程 访 问 
(RMI、Hessian、Burlap ) 以 及 Web Service 支 持 ， 并 提供 一 个 RestTemplate 类 来 进行 方 

便 的 Restful Services 访 问 。 

Portlet 模 块 : 提供 Portlet 环 境 支 持 。 


仅 供 非 商 业 用 途 或 交流 学 习 使 用 


中 


非 卖 品 ， 仅 供 非 商业 用 途 或 交流 学 习 使 用 
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3. AOP、Aspects 


@ AOP: 提供 了 符合 AOP Alliance 规 范 的 面向 切面 的 编程 (aspect-oriented programming ) 
实现 ， 提 供 比 如 日 志 记 录 、 权 限 控制 、 性 能 统计 等 通用 功能 和 业务 逻辑 分 离 的 技术 ， 
并 且 能 动态 地 把 这 些 功 能 添加 到 需要 的 代码 中 。 这 样 各 司 其 职 ， 降 低 业 务 逻 辑 和 通用 
功能 的 耦合 。 

e@ Aspects: 提供 了 对 AspectJ 的 集成 ，AspectJ 提 供 了 比 Spring ASP 更 强大 的 功能 。 


4. Core Container (核心 容器 ) 


e Spring-Beans: 提供 了 框架 的 基础 部 分 ， 包 括 控 制 反 转 和 依赖 注入 。 其 中 Bean Factory 
是 容器 核心 ， 本 质 是 “工厂 设计 模式 ”的 实现 ， 而 且 无 需 编 程 实现 “ 单 例 设计 模 
式 ”， 单 例 完 全 由 容器 控制 ， 而 且 提倡 面向 接口 编程 ， 而 非 面向 实现 编程 。 所 有 应 用 
程序 对 象 及 对 象 间 关系 由 框架 管理 ， 从 而 真正 从 程序 逻辑 中 ， 把 维护 对 象 之 间 的 依赖 
关系 提取 出 来 ， 所 有 这 些 依赖 关系 都 由 Bean Factory 来 维护 。 

e Spring-Core: 核心 工具 类 ， 封 装 了 框架 依赖 的 最 底层 部 分 ， 包 括 资源 访问 、 类 型 转换 
及 一 些 常用 工具 类 。 

e Spring-Context: 以 Core 和 Beans 为 基础 ， 集 成 Beans 模 块 功 能 并 添加 资源 绑 定 、 数 据 验 
证 、 际 化 、Java EE 支 持 、 容 器 生命 周期 、 事 件 传 播 等 。 核 心 接 口 是 
ApplicationContext。 

e Spring-SpEL: 提供 强大 的 表达 式 语言 支持 ， 支 持 访问 和 修改 属性 值 、 方 法 调用 ; 支持 
访问 及 修改 数组 、 容 器 和 索引 器 ， 命 名 变量 ， 支 持 算数 和 届 辑 运算 ， 支 持 从 Spring 容 
器 获取 Bean， 还 支持 列表 投影 、 选 择 和 一 般 的 列表 聚合 等 。 


5. Test 


Test 模 块 : Spring 支持 Junit 和 TestNG 测 试 框 架 ， 而 且 还 额外 提供 了 一 些 基 于 Spring 的 测 
试 功能 ， 比 如 在 测试 Web 框 架 时 ， 模 拟 HTTP 请 求 的 功能 。 


2.1.2 Spring MVC 简 述 


Spring MVC 属于 Spring Framework 的 后 续 产 品 ， 已 经 融合 在 Spring Web Flow 里 面 。Spring 
框架 提供 了 构建 Web 应 用 程序 的 全 功能 MVC 模块 。 使 用 Spring 可 插入 的 MVC 架构 ， 从 
而 在 使 用 Spring 进行 Web 开发 时 ， 可 以 选择 使 用 Spring 的 SpringMVC 框架 或 集成 其 他 MVC 
开发 框架 ， 如 Struts1 〈 现 在 一 般 不 用 ) 和 Struts2 一 般 老 项 目 使 用 ) 等 。 


2.1.3 MyBatis 简 述 


MyBatis 本 是 Apache 的 一 个 开源 项 目 iBatis，2010 年 这 个 项 目 由 Apache software foundation 


仅 供 非 商 业 用 途 或 交流 学 习 使 用 
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迁移 到 了 google code， 并 且 改 名 为 MyBatis。2013 年 11 月 迁移 到 Github。iBatis 一 词 来 源 于 
“internet” 和 “abatis” 的 组 合 ， 是 一 个 基于 Java 的 持久 层 框架 。iBatis 提供 的 持久 层 框架 包括 
SQL Maps 和 Data Access Objects (DAOs) 。 
MyBatis 是 一 款 优秀 的 持久 层 框架 ， 它 支持 定制 化 SQL、 存 储 过 程 及 高 级 映射 。MyBatis 
避免 了 几乎 所 有 的 JDBC 代码 和 手动 设置 参数 以 及 获取 结果 集 。MyBatis 可 以 使 用 简单 的 XML 
或 注解 来 配置 和 映射 原生 信息 ， 将 接口 和 Java 的 POJOs 映射 成 数据 库 中 的 记录 。 


2.2 ”快速 搭建 SSM 项 目 


2.2.1 快速 搭建 Web 项 目 


们 01 在 Intellij IDEA 的 菜单 栏 中 选择 【File】 一 【New】 一 【Project.….】, 在 弹出 的 【New 
Project】 窗 口中 选择 【Maven】， 勾 选 【Create from archetype】， 选 择 【maven-archetype-webapp]】 
单 击 【Next】 按钮 。 具 体 如 图 2-2 所 示 。 


New Projeet xX 
i iia moject SOK: | Ss TA tres vern 0.72 oe : Ne 
java Enterprise ow, 
pi . Wi Create from archetype ~ RG Archetype 
,eSBs x 3 
和 > ramel-arihetype War 
2 y 
> 
Cl vlots > 
2 Spring > {yodapg 
ov FX > Maven wh jin 
di > -marmalade-mojo 
Wh ancros 
» PES MVEN -Aree molo 
inteslif ylattorm Phgin 多 mayen rcherype portiet 
NE tp es 
oh spring initialier 多 PE Cy PDF 全 人 
> maeverrarcherype quickotars 
> ner site 
> Maverrarchw ty pe site-simple 


站 Gredle (Kitlin DS 
人 rite 


mavenachptype webapp 
SLASE 


ic 和 Sat 
netbwicket-orchetyp uickstant 


"PDS tasi 


人 


appfuse" basic"spricg 
appfuse -basic struts 


Wp Stoovy » Softewavbetypejst ™ 
D Griffon > es-SOftewarchetype-seam 
从 [到 址 > Softrelarchetype- Senn. 
Appiiration fiortye 六 HG 
> nnyfacesnehetype heliowril delets 
Statie Wets > :smyfaces-archetypejsfeomporents 
和 is > myfacesarchetype tinidad 
。 > strutsaarcherype sar 
Kotlin » 
» 
> 
》 
》 
总 


人 


| RN] Carwet #8 
图 2-2 New Product 窗口 
02 在 图 2-3 中 ， 填 写 【GroupId】 和 【ArtifactId】 等 信息 后 ， 单 击 【Next】 按 钮 。 


仅 供 非 商业 用 途 或 交流 学 习 使 用 
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区 New project x 
Groupld comay 


Aetifaethd | stringemewe-emeybaris book 


WTA A 


Previgts [ne ] Sareea Heip 
图 2-3 填写 Maven 相关 信息 窗口 


互 


03 在 【Maven home directory】 中 选择 Maven 的 安装 路 径 , 具体 见 1.4 节 Maven 安装 。 


在 【User settings file] 和 【Local repository】 中 选择 Maven 的 配置 文件 和 仓库 的 位 置 , 在 【Properties】 
属性 列表 中 添加 属性 名 name:， archetypeCatalog，value: internal。 具 体 如 图 2-4 所 示 。 


cg 


ey 


党 ey 
fershors Ft 
User ettincys Ble: Dapachernayes ,S$.0Nonh sortie wk » be Override 
ee 3 

Eocal repository: Dapache mavem 3 Srepostory ee” » Oenide 
PRE 
Se som Ay 4 
oiler Spi batis boow y 
versioe TPSNAPSHOT 
A ety < et tee 
YA > pe 
etypeweriiom RELEASE 

路 Nd Mevenrroperty ” 

Name archetypecatatody 

Valoe Finternak 

a OCS 
Previcaas Next Cancel Heip 


号 心 、 


图 2-4 填写 Maven 相关 信息 窗口 


仅 供 非 商 业 用 途 或 交流 学 习 使 用 
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Intellij IDEA 根据 maven archetype 的 本 质 , 执行 mvn archetype:generate 命令 。 该 命令 
执行 时 ， 需 要 指定 一 个 archetype-catalog.xml 文件 。 该 命令 的 参数 -DarchetypeCatalog 
可 选 值 为 : remote、internal、local 等 ， 用 来 指定 archetype-catalog.xml 文件 从 哪里 获 
取 ， 默 认为 remote， 即 从 http:/repol.maven.org/maven2/archetype-catalog.xml 路 径 下 
载 archetype-catalog.xml 文件 。archetype-catalog.xml 文件 约 为 3~4MB， 下 载 速 度 很 
慢 ， 导 致 创建 过 程 卡 住 。 解 决 的 办 法 很 简单 ， 指定 -DarchetypeCatalog 为 internal， 
即 可 使 用 maven 默认 的 archetype-catalog.xml， 而 不 用 从 remote 下 载 。 


4 单 击 【Next】 按 钮 ， 填 写 项 目 名 称 【springmvc-mybatis-book】， 单 击 【Finish】 按 
钮 ， 具 体 如 图 2-5 所 示 。 


名 New Project _ x 


Project name: ! springmve-mybatis-book 


Project locadom EA 次 M\springmve-mybatis-book 


TY More Settings 
Module name; springmve-mybatis-book 
Content root: EN pingmnve nybatis -book 


Module fie location: EN 站 springmve" rybatis-book 


project format; idea (directory based) 


Previows Cancal : Help 
图 2-5 填写 项 目 相关 信息 


TDO5 在 /src/main 目录 下 创建 java 和 test 目录 ， 并 标记 为 Sources 文件 ， 具 体 如 图 2-6 
所 示 。 至 此 ， 一 个 完整 的 Web 项 目 创建 完成 。 


仅 供 非 商业 用 途 或 交流 学 习 使 | 
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oye > Version24.0.0 /modelVersion> 
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Wjava 加 copy es factld>springmvyc-mybatis-book< /arty 
resoul Copy Path CtrlxSshift+C aging war‘ /packaging> 


5 本 1. 0-SNAPSHOT i 
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A pom.xmi Find in Path... Ctri+H erties 
ring. version’5. 0. 4.RELEASE‘ /spring 


perties 


springmyc-mybatis-book Maven Webap, 
nttp://maven. apache. ore</url> 


u SPringmvc-m Replace in Path... 
Bi External Librarie Analyze 
FindBugs 
Refactor > ndencies 


Add to Favorites 


3 ?endency> 
Show Image Thumbnails 


roupld org. springframework® /group]l 
Reformat Code CtrirAlrl IrtifactId spring-core’/artifactId 
Optimize imports CtrirAlt+0) rersion>$ {spring, version} “</version 
Delete... Deiste Pendency 


Run Maven 2andency 起 


oupld org. springframework /groupy 
Build Module 'springmvc-mybatis-book’” ‘rtifactId ge /artifactl| 


Debug Maven > 


rersion $ {spring/Yersion} “/version 
Local History 
?pendency 
Git 


es 
Synchronize java 
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Show in Explorer 
2 Resources Root 
i dE + 和 
Directory Path CtrirAR+Fi2 | 8% ER nt 


es Maver Goal Compare With... iD my Excluded 


FEIHNF03 project crea Miark Directory as 二 Generated Sources Root netypel 


图 2-6 创建 java 目录 


2.2.2 ”集成 Spring 


在 2.2.1 节 中 ， 通 过 Intellij IDEA 已 经 创建 好 Web 项 目 ， 本 节 主 要 介绍 如 何在 Web 项 目 中 
集成 Spring 框架 ， 具 体 步 又 如 下 : 


首先 ， 在 springmvc-mybatis-book 项 目的 pom 文件 中 添加 Spring 相关 的 依赖 ， 具 体 代 码 
如 下 : 


<properties> 
<spring.version>5.0.4.RELEASE</spring.version> 
</properties> 
<dependencies> 
<!I——-spring start -=-> 
<dependency> 
<groupIld>org.springframework</groupId> 
<artifactId>spring-core</artifactId> 
<version>${spring.version}</version> 
</dependency> 


<dependency> 


第 2 章 ”快速 搭建 第 一 个 SSM 项 目 | 17 


<grouplId>org.springframework</groupId> 

<artifactId>spring-beans</artifactId> 

<version>${spring.version}</version> 
</dependency> 


<dependency> 
<groupId>org.springframework</grouplId> 
<artifactId>spring-context</artifactId> 
<version>${spring.version}</version> 


</dependency> 


<dependency> 
<groupId>org.springframework</groupId> 
<artifactlid>spring-context-support</artifactId> 
<version>${spring.version}</version> 


</dependency> 


<dependency> 
<groupId>org.springframework</group1Id> 
<artifactId>spring-aop</artifactId> 
<version>${spring.version}</version> 


</dependency> 


<dependency> 
<groupld>org.springframework</groupld> 
<artifactId>spring-aspects</artifactId> 
<version>${spring.version}</version> 
</dependency> 


<dependency> 
<groupId>org.springframework</groupId> 
<artifactId>spring-expression</artifactId> 
<version>${spring.version}</version> 
</dependency> 


<dependency> 
<groupld>org.springframework</groupId> 
<artifactId>spring-tx</artifactId> 
<version>${spring.version}</version> 
</dependency> 


<dependency> 
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<gFroupIQ>org.spPringframework</groupId> 

<artifactId>spring-test</artifactId> 

<version>${spring.version}</version> 
</dependency> 


<dependency> 
<groupId>org.springframework</groupId> 
<artifactId>spring-web</artifactId> 
<version>${spring.version}</version> 

</dependency> 

< Srlndg end =—> 


eT te 
<dependency> 
<grouplId>junit</groupId> 
<artifactIid>junit</artifactId> 
<version>4.12</version> 
</dependency> 
</dependencies> 


其 次 ， 在 /src/main/resources 目录 下 创建 applicationContext.xml 配置 文件 ， 具 体 代码 如 下 : 


<?xml] Version="1.0" encoding="UTF-8"?> 
<beans xmlns="http://www.springframework.org/schema/beans" 
xmlns:xsi="http://www.w3.o0rg/2001/xXMLSchema-instance" 
xmlns:context="http://www.springframework.org/schema/context" 
xmlns:tx="http://www.springframework.org/schema/tx" 
xsi:schemaLocation="http://www.springframework.org/schema/beans 
http://www.springframework.org/schema/beans/ 
spring-beans-2.5.xsd 
http://www.springframework.org/schema/tx 
http://www.springframework.org/schema/tx/spring-tx.xsd 
http://www.springframework.org/schema/context 


http://www.springframework.org/schema/context/spring-context-2.5.xsd"> 
<context:component-scan base-package="com.ay"/> 


</beans> 


e <context:component-scan/> 注 解 : 扫描 base-package 包 或 者 子 包 下 所 有 的 Java 类 ， 并 把 
匹配 的 Java 类 注册 成 Bean。 这 里 我 们 设置 扫描 com.ay 包 下 的 所 有 Java 类 。 


org. 
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接着 ， 在 web.xml 配置 文件 中 添加 如 下 代码 : 


<!IDOCTYPE web-app PUBLIC 
"-//Sun Microsystems, Inc.//DTD Web Application 2.3//EN" 
"http://java.sun.com/dtd/web-app 2 3.dtd" > 
<web-app> 
<display-name>Archetype Created Web Application</display-name> 
<context-param> 
<param-name>contextConfigLocation</param-name> 
<param-value>classpath:applicationContext.xml</param-value> 
</context-param> 
<listener> 
<listener-class> 
org.springframework.web.context.ContextLoaderListener 
</listener-class> 
</listener> 


</web-app> 


e <context-param>: 整个 项 目的 全 局 变量 ， 相 当 于 设 定 了 一 个 固定 值 。param-name 是 
键 ， 相 当 于 就 是 参数 名 ，param-value 是 值 ， 相 当 于 参数 值 。 

e ContextLoaderListener: ContextLoaderListener 监 听 器 实现 了 ServletContextListener 接 
口 ， 其 作用 是 启动 Web 容 器 时 ， 自 动 装 配 ApplicationContext 的 配置 信息 。 在 web.xml 配 
置 这 个 监听 器 ， 启 动容 器 时 ， 就 会 默认 执行 它 实 现 的 方法 。 


最 后 ， 在 src/main/test/com.ay.test 目录 下 创建 SpringTest 测试 类 ， 具 体 代码 如 下 : 


import org. junit.Test, 

import org.springframework.context.ApplicationContext; 
import 
springframework.context.support.ClassPathXmlApplicationContext; 
import org.springframework.stereotype.Service; 

/** 

* Qauthor Ay 

* @date 2018/04/02 ‘ 

*/ 

@Service 

public class SpringTest { 


@Test 
public void testSpring(){ 


// 获 取 运 用 上 下 文 
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ApplicationContext applicationContext = 
new ClassPathxmlApplicationContext ("applicationContext.xml"); 
// 获 取 SpringTest 类 
SpringTest springTest = 
(SpringTest) applicationContext.getBean ("springTest"); 
// 调 用 sayHello 方法 
springTest.sayHello(); 


public void sayHello()t 
System.out .Println("hel1lo ay") ， 


} 

e @Service: Spring 会 自动 打 描 到 @Service 注 解 的 类 ， 并 把 这 些 类 纳入 进 Spring 容 器 中 管 
理 。 也 可 以 用 @Component 注 解 ， 只 是 @Service 注 解 更 能 表明 该 类 是 服务 层 类 。 

e ApplicationContext 容 器 : ApplicationContext 是 Spring 中 较 高 级 的 容器 ， 它 可 以 加 载 配 
置 文件 中 定义 的 Bean， 并 将 所 有 的 Bean 集 中 在 一 起 ， 当 有 请 求 的 时 候 分 配 Bean。 


最 经 常 被 使 用 的 ApplicationContext 接口 实现 如 下 : 


e ClassPathXmlApplicationContext: 从 类 路 径 ClassPath 中 寻找 指定 的 XML 配置 文件 ， 
找到 并 装载 完成 ApplicationContext 的 实例 化 工作 ， 有 具体 代码 如 下 : 


// 装 载 单个 配置 文件 实例 化 ApplicationContext 容器 

ApplicationContext cxt = new ClassPathXmlApplicationContext 
("applicationContext.xml"); 

// 装 载 多 个 配置 文件 实例 化 ApplicationContext 容器 

String[] configs = {"beanl.xml","bean2.xml","bean3.xml"}; 


ApplicationContext cxt = new ClassPathXmlApplicationContext (configs); 


e FileSystemXmlApplicationContext: 从 指定 的 文件 系统 路 径 中 寻找 指定 的 XML 配置 文 
件 ， 找 到 并 装载 完成 ApplicationContext 的 实例 化 工作 。 上 有 具体 代码 如 下 : 


// 装 载 单个 配置 文件 实例 化 ApplicationContext 容器 

ApplicationContext cxt = new FileSystemXMLApplicationContext ("beans.xml"); 
// 装 载 多 个 配置 文件 实例 化 ApplicationContext 容器 

Stringll ‘configs = [mom /Deans Ll xml Uo/ eanms 2 ml 


ApplicationContext cxt = new FileSystemxXxmlApplicationContext (configs)， 
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e XmlWebApplicationContext: 从 Web 应 用 中 寻找 指定 的 XML 配置 文件 ， 找 到 并 装载 完 
成 ApplicationContext 的 实例 化 工作 。 这 是 为 Web 工程 量 身 定 制 的 ， 使 用 
WebApplicationContextUtils 类 的 getRequiredWebApplicationContext 方法 可 在 JSP 与 
Servlet 中 取得 IOC 容 器 的 引用 。 


运行 上 面 代码 中 的 单元 测试 方法 testSpring()， 便 可 以 在 Intellij IDEA 控制 台 看 到 如 图 2-7 所 
示 的 结果 ， 表 示 Web 应 用 集成 Spring 框架 成 功 。 


Connected to the target VM, address: '127.0.0.1:65035", transport: ' socket 
四 月 02，2018 12:53:33 下 午 org, springframeworl, context. support. AbstractApplicationContext prepareRefresh 


J 


信息 : Refreshing org. springframework,. context, support.ClassPathxmlApplicationContext@52525845: startup dat, 
四 月 62，2018 ka:53:34 下 午 org. springframework. beans. factory, xml. XmlBeanDefinitionReader loadBeanDefinitj 
信息 : Loading XML bean definitions from class path resource [applicationContest. xml)} 

hello ay 

Disconnected from the target VM, address: ‘127.0.0.1:65035’, transport: ”Socket 


Process finished with exit code 0 
图 2-7 Web 应 用 集成 Spring 框架 


2.2.3 ”集成 Spring MVC 框架 


Web 项 目 集成 Spring 框架 之 后 ， 我 们 继续 把 Spring MVC 集成 进来 ， 有 具体 的 步骤 如 下 ; 
首先 ， 把 集成 Spring MVC 所 需要 的 Maven 依赖 包 和 相关 的 属性 值 添加 到 pom.xml 文件 
中 ， 有 具体 代码 如 下 : 


<properties> 
<spring.version>5.0.4.RELEASE</spring.version> 
<javax.servlet.version>4.0.0</javax.servilet.version> 
<jstl.version>1.2</jstl.version> 
</properties> 
<!i--springmve start = 一 > 
<dependency> 
<groupId>jsti</groupId> 
<artifactId>jstl</artifactId> 
<version>${jstl.version}</version> 
</dependency> 
<dependency> 
<groupId>javax.servlet</groupId> 
<artifactId>javax.servilet-api</artifactId> 
<version>$ {javax.servlet.version}</version> 


</dependency> 
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<dependency> 
<groupId>org.springframework</groupId> 
<artifactId>spring-webmvc</artifactId> 
<version>${spring.version}</version> 

</dependency> 

<l—-SprLngmve end 一 一 六 


其 次 ， 在 web.xml 配置 文件 中 添加 DispatcherServlet 配置 ， 具 体 代码 如 下 : 


<!-- 配 置 DispatcherServlet --> 
<Servliet> 
<servlet-name>spring-dispatcher</servlet-name> 
<servlet-class>org.springframework.web.servilet.DispatcherServlet 
</servlet-class> 
<!-- 配置 SpringMVC 需要 加 载 的 配置 文件 spring-mvc.xml --> 
<init-param> 
<param-name>contextConfigLocation</param-name> 
<param-value>classpath:spring-mvc.xml</param-value> 
</init-param> 
<load-on-startup>1</load-on-startup> 
</servlet> 
<servlet-mapping> 
<servilet-name>spring-dispatcher</servlet-name> 
<!-- 默认 匹配 所 有 的 请 求 --> 
<url-pattern>/</url-pattern> 
</servlet-mapping> 


e DispatcherServlet 类 : DispatcherServlet 是 前 置 控制 器 ， 主 要 用 于 拦截 匹配 的 请 求 ， 拦 
截 匹配 规则 要 自己 定义 ， 把 拦截 下 来 的 请 求 ， 依 据 相 应 的 规则 分 发 到 目标 Controller 来 
处 理 ， 是 配置 Spring MVC 的 第 一 步 。 

e <init-param>: 整个 项 目的 局 部 变量 ， 相 当 于 设 定 了 一 个 国定 值 ， 只 能 在 当前 的 Servlet 
中 被 使 用 。param-name 是 键 ， 相 当 于 就 是 参数 名 ，param-value 是 值 ， 相 当 于 参数 值 。 
容器 启动 时 会 加 载 配 置 文件 spring-mvc.xml。 

e <load-on-startup>: 表示 启动 容器 时 初始 化 该 Servlet。 当 值 为 0 或 者 大 于 0 时 ， 表 示 容 
器 在 应 用 启动 时 加 载 并 初始 化 这 个 Servlet。 如 果 值 小 于 0 或 未 指定 时 ， 则 指示 容器 在 该 
Servlet 被 选择 时 才 加 载 。 正 值 越 小 ，Servlet 的 优先 级 越 高 ， 应 用 启动 时 就 越 先 加 载 。 值 
相同 时 ， 容 器 就 会 自己 选择 顺序 来 加 载 。 


e <Servlet-mapping>: 标签 声明 了 与 该 Servlet 相 应 的 匹配 规则 ， 每 个 <url-pattern> 标 签 代 


表 1 个 匹配 规则 。 


非 卖 品 ， 仪 f 


t 非 商业/ 


j 途 或 交流 学 习 使 用 
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e <url-pattern>: UREL 匹 配 规则 ， 表 示 哪 些 请 求 交 给 Spring MVC 处 理 ，“/” 表 示 拦 截 所 


有 的 请 求 。 
URL 匹配 规则 有 如 下 几 种 : 


(1) 精准 匹配 
<url-pattern> 中 的 配置 项 必须 与 URL 完全 精确 匹配 。 


<servlet-mapping> 
<servlet-name>spring-dispatcher</servilet-name> 
<!-- 精准 匹配 --> 
<url-pattern>/ay</url-pattern> 
<url-pattern>/index.html</url-pattern> 
<url-pattern>/test/ay.html</url-pattern> 
</servlet-mapping> 


当 在 浏览 器 中 输入 如 下 几 种 URL 时 ， 都 会 被 匹配 到 该 Servlet， 具 体 代 码 如 下 : 


http://localhost/ay 
http://localhost/index.html 
http://localhost/test/ay.html 

(2) 扩展 名 匹配 

以 “*.” 开 头 的 字符 串 被 用 于 扩展 名 匹配 。 


<servlet-mapping> 


<servlet-name>spring-dispatcher</servlet-name> 

< 扩展 名 匹配 ==> 

<url-pattern>*.jsp</url-pattern> 
</servlet-mapping> 


当 在 浏览 器 中 输入 如 下 几 种 URL 时 ， 都 会 被 匹配 到 该 Servlet， 有 具体 代码 如 下 : 


http://localhost/ay.jsp 
http://localhost/al.jsp 


(3) 路 径 匹 配 
以 “/” 字 符 开 头 ， 并 以 “/*” 结 尾 的 字符 串 用 于 路 径 匹 配 。 


<servlet-mapping> 
<servlet-name>spring-dispatcher</servlet-name> 
<! 一 扩展 名 匹配 --> 
<url-pattern>/ay/*</url-pattern> 
</servilet-mapping> 


非 卖 品 ， 仪 供 非 商 业 用 途 或 交流 学 习 使 用 
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当 在 浏览 器 中 输入 如 下 几 种 URL 时 ， 都 会 被 匹配 到 该 Servlet， 共 体 代码 如 下 : 


http://localhost/ay/ay.jsp 
http://localhost/ay/ay.html 
http://localhost/ay/action 
http://localhost/ay/xxxx 
http://localhost/ay/xxxXxx.do 


路 径 匹 配 和 扩展 名 匹配 无 法 同时 设置 ， 如 果 设 置 ， 启 动 tomcat 服务 器 会 报错 。 例 如 
下 面 3 个 匹配 规则 是 错误 的 : 


en， 
a 时 


<url-pattern>/kata/*.jsp</url-pattern> 
<url-pattern>/*.jsp</url-pattern> 
<url-pattern>he*.jsp</url-pattern> 


(4) 默认 匹配 


<servlet-mapping> 
<servlet-name>spring-dispatcher</servlet-name> 
<! 一 - 默认 匹配 所 有 的 请 求 --> 
<url-pattern>/</url-pattern> 
</servlet-mapping> 


(5 ) 匹配 顺序 
当 一 个 URL 与 多 个 Servlet 的 匹配 规则 可 以 匹配 时 ， 则 按照 “精确 路 径 > 最 长 路 径 > 扩 
展 名 ”这 样 的 优先 级 匹配 到 对 应 的 Servlet。 举 例如 下 : 

@ 比如 ServletA 的 Url-pattern 为 Htest，ServletB 的 url-pattern 为 /#* ， 如 果 访 问 的 URL 路 径 为 
http://localhost/test ， 容 器 会 优先 进行 精确 路 径 匹 配 ， 发 现 /test 正 好 被 ServletA 精 确 匹 
配 ， 那 么 就 会 去 调用 ServletA， 而 不 是 ServletB。 

@ 比如 ServletA 的 Url-pattern 为 testl#*， 而 ServletB 的 url-pattern 为 /testya/#*， 如 果 访 问 的 URL 
路 径 为 http:Wlocalhosttesta， 容 器 会 选择 路 径 最 长 的 Servlet 来 匹配 ， 也 就 是 ServletB。 

@ 比如 ServletA 的 Url-pattern: *.action ，ServletB 的 url-pattern 为 /* 。 如 果 访 问 的 URL 路 径 
为 http://localhost/test.action， 容 器 会 优先 进行 路 径 匹 配 ， 而 不 是 扩展 名 匹配 ， 这 样 就 去 
调用 ServletB。 


接着 ， 我 们 在 /src/main/resources 目录 下 创建 配置 文件 spring-mvc.xml， 有 具体 代码 如 下 : 


<?xml] version="1.0" encoding="UTF-8"?> 

<beans xmlns="http://www.springframework.org/schema/beans" 
xmlns:xsi="http://www.w3.0rg/2001/xXMLSchema-instance" 
xmlns:context="http://www.springframework.org/schema/context" 


非 卖 品 ， 仅 供 非 商业 用 途 或 交流 学 习 使 用 


第 2 章 快速 搭建 第 一 个 SSM 项 目 | 25 


xmlns:mve="http://www.springframework.org/schema/mve" 

xmlns:aop="http://www.springframework.org/schema/aop" 

xsi:schemaLocation="http://www.springframework.org/schema/beans 
http://www.springframework.org/schema/beans/spring-beans.xsd 
http://www.springframework.org/schema/context 
http://www.springframework.org/schema/context/spring-context.xsd 
http://www.springframework.org/schema/mvce 
http://www.springframework.org/schema/mvc/spring-mvc.xsd 
http://www.springframework.org/schema/aop 
http://www.springframework.org/schema/aop/spring-aop.xsd"> 


<!-- 扫描 controller (后 端 控制 器 ) ,并 且 扫 描 其 中 的 注解 -=-> 
<context:component-scan base-package="com.ay.controller"/> 
<!-- 设 置 配 置 方案 --> 


<mvc:annotation-driven/> 


<!-- 配 置 JSP 显示 ViewResolver (视图 解析 器 ) -=-> 
<bean class="org.springframework.web.servilet .view. 
InternalResourceViewResolver"> 
<property name="viewClass" 
value="org.springframework.web.servlet.view.JstlView"/> 
<property name="prefix" value="/WEB-INF/views/"/> 
<property name="suffix" value=".jsp"/> 
</bean> 
</beans> 


e <context:component-scan>: 扫描 base-package 包 或 者 子 包 下 所 有 的 controller 类 ， 并 把 
匹配 的 controller 类 注册 成 Bean。 

e <mvc:annotation-driven/> : 该 注解 会 自动 注册 RequestMappingHandlerMapping 和 
RequestMappingHandlerAdapter 两 个 Bean， 是 Spring MVC 为 @Controller 分 发 请 求 所 必须 
的 ， 并 提供 了 数据 绑 定 支持 、@NumberFormatannotation 支持 、@DateTimeFormat 支 
持 、@Valid 支 持 、 读 写 XML 的 支持 (JAXB ) 和 读 写 JSON 的 支持 (Jackson ) 等 功能 。 

e InternalResourceViewResolver: 最 常用 的 视图 解析 器 ， 当 控制 层 返 回 “hello” 时 ， 
InternalResourceViewResolver 解 析 器 会 自动 添加 前 级 和 后 级 ， 最 终 路 径 结 果 为 : 
/WEB-INF/views/hello.jsp, 


最 后 ， 在 /src/main/java 目录 下 创建 包 com.ay.controller， 并 创建 控制 层 类 AyTestController， 
具体 代码 如 下 : 
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package com.ay.controller; 
import org.springframework.web.bind.annotation.GetMapping; 
import org.springframework.web.bind.annotation.RequestMapping; 
import org.springframework.web.bind.annotation.RestController; 
WX 
*@Qauthor Ay 
* @date 2018/04/02 
wy 
@Controller 
@RequestMapping("/test") 
public class AyTestController { 
@GetMapping ("/sayHello") 
public String sayHello(){ 
return "hellio"; 


ee @Controller: 标明 AyTestController 是 一 个 控制 器 类 ， 使 用 @Controller 标 记 的 类 就 是 
一 个 Spring MVC Controller 对 象 。 

e @RequestMapping: 是 一 个 用 来 处 理 请 求 地 址 映射 的 注解 ， 可 用 于 类 或 者 方法 上 。 用 
于 类 上 ， 表 示 类 中 的 所 有 响应 请 求 的 方法 都 是 以 该 地 址 作为 父 路 径 。 
@RequestMapping 注 解 有 value、method 等 属性 ，value 属 性 可 以 默认 不 写 。“/test” 就 是 
value 属 性 的 值 。value 属 性 的 值 就 是 请 求 的 实际 地 址 。 

e @GetMapping : @GetMapping 是 一 个 组 合 注 解 ， 是 @RequestMapping(method = 
RequestMethod.GET) 的 缩写 。 该 注解 将 HTTP Get 请 求 映射 到 特定 的 处 理 方法 上 。 类 似 
的 @PostMapping 注 解 是 @RequestMapping(method = RequestMethod.POST) 的 缩写 。 
@PutMapping 注解 是 @RequestMapping(method = RequestMethod.PUT) 的 缩写 。 
@DeleteMapping 注 解 是 @RequestMapping(method = RequestMethod.DELETE) 的 缩写 。 
@PatchMapping 注 解 是 @RequestMapping(method = RequestMethod.PATCH) 的 缩写 。 


| 


在 /src/main/webapp/WEB-INF 目录 下 创建 views 文件 夹 ， 在 views 文件 下 创建 hello.jsp 文 
件 ， 有 具体 代码 如 下 : 


<%Qpage language="java" contentType="text/html; charset=UTF-8" 
pageEncoding="UTF-8" $%> 
<!DOCTYPE HTML> 
<html> 
<head> 
<title>Getting Started: Serving Web Content</title> 
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成 功 启 动 Tomcat 服务 器 后 ， 在 浏览 器 输入 访问 路 径 : 
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<meta http-equiv="Content-Type" content="text/html; charset=UTF-8" /> 
</head> 
<body> 
hello, ay 
</body> 
</html> 


至 此 ，Web 项 目 集 成 Spring MVC 大 功 告 成 。 我 们 把 Web 项 目 部 署 到 Tomcat 服务 器 上 ， 


如 图 2-8 所 示 的 结果 时 ， 代 表 Web 项目 集成 Spring MVC 成 功 。 


CG | © localhost808 
车 应 用 党 二 度 ” 兰 [搜索 兰 [CSDN】 ” 兰 [技术 闪 坛 ] 
hello, ay 
图 2-8 集成 Spring MVC 框架 测试 


2.2.4 集成 MyBatis 框架 


http://localhost:8080/test/sayHello。 当 出 现 


在 2.2.3 节 中 ， 我 们 已 经 在 Web 项 目 中 集成 了 Spring MVC， 这 一 节 主 要 介绍 如 何在 Web 


项 目 中 集成 MyBatis 框架 。 


首先 ， 把 集成 MyBatis 框架 所 需要 的 依赖 包 添加 到 pom.xml 文件 中 ， 具 体 代码 如 下 : 


<properties> 
<spring.version>5.0.4.RELEASE</spring.version> 
<javax.servilet.version>4.0.0</javax.servlet.version> 
<jstl.version>1.2</jstl.version> 
<mybatis.version>3.4.6</mybatis.version> 


<mysql.connector.java.version>8.0.9-rc</mysql.connector.java.version> 


<druid.version>1.1.9</druid.version> 
<mybatis.spring.version>1.3.2</mybatis.spring.version> 
</properties> 
< mvoatis Start -> 
<dependency> 
<groupId>mysql</groupId> 
<artifactId>mysql-connector-java</artifactId> 
<version>$ {mysqgql.connector.java.version}</version> 


<scope>runtime</scope> 
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</dependency> 


<dependency> 
<groupId>com.alibaba</groupId> 
<artifactId>druid</artifactId> 
<version>${druid.version}</version> 
</dependency> 


<dependency> 
<groupld>org.springframework</groupId> 
<artifactId>spring-jdbc</artifactId> 
<version>${spring.version}</version> 
</dependency> 


<dependency> 
<groupld>org.mybatis</groupId> 
<artifactId>mybatis</artifactId> 
<version>${mybatis.version}</version> 
</dependency> 


<dependency> 
<groupld>org.mybatis</groupId> 
<artifactId>mybatis-spring</artifactId> 
<version>$ {mybatis.spring.version}</version> 
</dependency> 
<!——mybatis end -> 


e mysql-connector-java: 是 MySQL 的 JDBC 了 驱动 包 ， 用 JDBC 连 接 MySQL 数 据 库 时 必须 
使 用 该 jar 包 。 

® druid: Druid 是 阿里 巴巴 开源 平台 上 一 个 数据 库 连接 池 实 现 ， 它 结合 了 C3P0、DBCP、 
PROXOOL 等 DB 连接 池 的 优点 ， 同 时 加 入 了 上 日志 监控 ， 可 以 很 好 地 监控 DB 连接 池 和 
SQL 的 执行 情况 ， 可 以 说 是 针对 监控 而 生 的 DB 连接 池 ， 据 说 是 目前 最 好 的 连接 池 。 

e mybatis-spring: mybatis-spring 会 帮助 你 将 MyBatis 代 码 无 颖 地 整合 到 Spring 中 。 使 用 这 
个 类 库 中 的 类 ，Spring 将 会 加 载 必 要 的 MyBatis 工 厂 类 和 Session 类 。 


其 次 ， 在 /src/main/resources 目录 下 创建 jdbc.properties 配置 文件 ， 有 具体 代码 如 下 : 
// 驱 动 


jdbc.driverClassName=com.mysql.jdbc.Driver 
//mysql 连接 信息 


7 
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jdbc.url=jdbc:mysql://127.0.0.1:3306/springmvc-mybatis-book?serverTimezo 
ne=GMT 

// 用 户 名 

jdbc.username=root 

// 密 码 

jdbc.password=123456 


e jdbc.properties 配 置 : 主要 配置 驱动 和 连接 数据 库 的 配置 信息 。 
最 后 ， 在 applicationContext.xml 配置 文件 添加 如 下 的 配置 ， 有 具体 代码 如 下 : 
<!--1、 配 置 数据 库 相 关 参 数 --> 


<context:property-placeholder 
location="classpath:jdbc.properties" ignore-unresolvable="true"/> 


<1--2 .数据 源 druiqd --> 
<bean id="dataSource" class="com.alibaba.druid.pool.DruidDataSource" 
init-method="init" destroy-method="close"> 
<property name="driverClassName" value="$ {jdbc.driverClassName}" /> 
<property name="url" value="${jdbc.url}" /> 
<property name="username" value="${jdbc.username}" /> 
<property name="password" value="${jdbc.password}" /> 
</bean> 
<!--3、 配 置 SqglSessionFactory 对 象 --> 
<bean id="sqlSessionFactory" class="org.mybatis.spring. 
SqlSessionFactoryBean"> 
<!-- 注 入 数据 库 连 接 池 --> 
<property name="dataSource" ref="dataSource"/> 
<!-- 扫 描 sql 配置 文件 :mapper 需要 的 xml 文件 --> 
<property name="mapperLocations" value="classpath:mapper/*.xml"/> 
</bean> 


<bean id="sqlSession" class="org.mybatis.spring.SqlSessionTemplate"> 
<constructor-arg index="0" ref="sqlSessionFactory”" /> 
</bean> 


<!-- 扫描 basePackage 下 所 有 以 6MyBatisDao 注解 的 接口 --> 
<bean id="mapperScannerConfigurer" 
class="org.mybatis.spring.mapper. MapperScannerConfigurer"> 
<property name="sqlSessionFactoryBeanName" value="sqlSessionFactory" /> 
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<property name="basePackage" value="com.ay.dao"/> 
</bean> 


e <context:property-placeholder/>: 标签 提供 了 一 种 优雅 的 外 在 化 参数 配置 的 方式 ， 
location 表 示 属 性 文件 位 置 ， 多 个 属性 文件 之 间 通 过 过 号 分 隔 。ignore-unresolvable 表 示 
是 否 忽 略 解析 不 到 的 属性 ， 如 果 不 忽 略 ， 找 不 到 将 抛 出 异常 。 

e DruidDataSource: 阿里 巴巴 Druid 数 据 源 ， 该 数据 源 会 读 取 jdbc.properties 配 置 文件 的 
数据 库 连 接 信息 和 驱动 。 

e@ SqlSessionFactoryBean : 在 基本 的 MyBatis 中 ， Session 工厂 可 以 使 用 
SqlSessionFactoryBuilder 来 创建 。 而 在 MyBatis-Spring 中 ， 则 使 用 SqlSessionFactoryBean 来 
替代 。 


SqlSessionFactoryBean 需要 依赖 数据 源 dataSource。mapperLocations 属性 可 以 用 来 指定 
MyBatis 的 XML 映射 器 文件 的 位 置 ， 值 为 mapper/*.xml 代表 扫描 classpath 路 径 下 mapper 文件 
夹 下 的 所 有 XML 文件 。 


e MapperScannerConfigurer: 我 们 没有 必要 在 Spring 的 XML 配置 文件 中 注册 所 有 的 映射 
器 。 相 反 ， 可 以 使 用 MapperScannerConfigurer， 它 将 会 查找 类 路 径 下 的 映射 器 并 自动 
将 它们 创建 成 MapperFactoryBean。basePackage 属 性 是 让 你 为 映射 器 接口 文件 设置 基本 
的 包 路 径 。 可 以 使 用 分 号 或 过 号 作为 分 隔 符 设置 多 于 一 个 的 包 路 径 。 每 个 映射 器 将 会 
在 指定 的 包 路 径 中 递归 地 被 搜索 到 。 这 里 设置 的 值 是 com.ay.dao 这 个 包 。 


Web 应 用 集成 MyBatis 框架 所 需 的 配置 文件 都 添加 完成 之 后 ， 我 们 开始 开发 相关 的 代码 。 
首先 ， 在 MySQL 数据 库 创建 表 ay_user， 具 体 的 SQL 语句 如 下 : 


BDROE "TABLE Lh MSDSO av Sere 

EREATE TABLEr Vay UUSee ( 

'id' bigint(32) NOT NULL AUTO INCREMENT, 

'name' varchar (10) DEFAULT NULL, 

'password' varchar (64) DEFAULT NULDL, 

PRIMARY KEY ('id') 

ENGINE=InnoDB AUTO INCREMENT=2 DEFAULT CHARSET=utf8; 


数据 库 表 创建 完成 之 后 ， 往 ay_user 表 插 入 数据 ， 有 具体 如 图 2-9 所 示 。 


~ 一 


x 
仅 供 非 商业 用 途 或 交流 学 习 使 用 


第 2 章 快速 搭建 第 一 个 SSM 项 目 | 31 


Say user @springmvc-mybati... 


弘 备注 * 生僻 先 措 排 序 [这 导入 国有 出 


password 
123 


123 


图 2-9 用 户 数 据 


数据 库 表 创 建 完成 之 后 ， 在 /src/main/java/com.ay.model 目录 下 创建 数据 库 表 对 应 的 实体 类 
对 象 AyUser， 有 具体 的 代码 如 下 : 


/** 

* 用 户 实体 

* Qauthor Ay 

* @date 2018/04/02 

#7 

public class AyUser implements Serializablef{ 


private Integer id; 
private String name; 


private String password; 


// 省 略 set、get 方法 
} 


实体 类 对 象 AyUser 创建 完成 之 后 ， 在 /src/main/java/ com.ay.dao 目录 下 创建 对 应 的 DAO 对 
象 AyUserDao，AyUserDao 是 一 个 接口 ， 提 供 了 findAll 方法 用 来 查询 所 有 的 用 户 。AyUserDao 
具体 代码 如 下 : 


package com.ay.dao; 

import com.ay.model.AyUser; 

import org.springframework.stereotype.Repository; 
Limport Jova. UC .Llsty 


@Repository 
public interface AyUserDao { 


List<AyUser> findAll (); 
} 


接口 类 AyUserDao 创建 完成 之 后 ， 在 /src/main/java/com.ay.service 目录 下 创建 对 应 的 服务 层 
接口 AyUserService， 服 务 层 接口 AyUserService 代码 也 非常 简单 ， 只 提供 了 一 个 查询 所 有 用 户 
的 方法 findAlHO， 且 体 的 代码 如 下 : 
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package com.ay.service; 
import com.ay.model.AyUser; 
import java.util.List; 


public interface AyUserService 1{ 


List<AyUser> findAll(); 
} 


服务 层 接口 AyUserService 开发 完成 之 后 ， 在 /src/maimjava/com.ay.service.impl 开发 对 应 的 
服务 层 实现 类 AyUserServiceImpl， 实 现 类 主要 是 注入 AyUserDao 接口 ， 并 实现 findAll() 方 法 ， 
在 findAll0 方 法 中 调用 AyUserDao 的 findAll0 方 法 ， 具 体 代码 如 下 所 示 : 


package com.ay.service.impl; 

import com.ay.dao.AyUserDao; 

import com.ay.model.AyUser; 

import com.ay.service,.AyUserService; 

import org.springframework.stereotype.Repository; 
import org.springframework.stereotype.Service; 
import javax.annotation.Resource; 

import JjJava.util.List; 

@Service 


public class AyUserServiceImpl implements AyUserServicef{ 


QResource 


private AyUserDao ayUserDao; 


public List<AyUser> findAll() { 
return ayUserDao.listAllUser (); 


} 


服务 层 实 现 类 AyUserServiceImpl 开发 完成 之 后 ， 在 /src/main/java/com.ay.controller 目录 下 
创建 控制 层 类 AyUserController， 并 注入 服务 层 接口 。AyUserController 类 只 有 一 个 findAll() 方 
法 。 在 AyUserController 类 上 添加 映射 路 径 /user， 在 findAll0 方 法 上 添加 映射 路 径 /findAll。 


package com.ay.controller; 

import com.ay.model.AyUser; 

import com.ay.service.AyUserService; 

import org.springframework.stereotype.Controller; 
import org.springframework.ui.Model; 
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import org.springframework.web.bind.annotation.GetMapping; 
import org.springframework.web.bind.annotation.RequestMapping; 
import javax.annotation.Resource; 

moort java Util. List,; 


/Kx 
*xQ@author Ay 
* @date 2018/04/02 
de 
@Controller 
@RequestMapping (value = "/user") 
public class AyUserController { 


@Resource 


private AyUserService ayUserService; 


@GetMapping ("/findAll") 
public String findAll (Model model){ 
List<AyUser> ayUserList = ayUserService.findAll (); 
for (AyUser ayUser : ayUserList)t{ 
System.out.println("id:" + ayUser.get1Id()); 
System.out.println("name: " + ayUser.getName ()); 
} 


return "hello"; 


} 
最 后 ， 在 /src/main/resources 目录 下 创建 AyUserMapper.xml 文件 ， 具 体 代码 如 下 : 


<?xml version="1.0" encoding="UTF-8" ?> 
<!IDOCTYPE mapper PUBLIC "-//mybatis.org//DTD Mapper 3.0//EN" 
"http://mybatis.org/dtd/mybatis-3-mapper.dtd"> 
<mapper namespace="com.ay.dao.AyUserDao"> 
<sql id="userField"> 
a li eo, 
a.name as "name", 
a.password as "password" 
</sql> 
<!-- 获取 所 有 用 户 --> 


仅 供 非 商业 用 途 或 交流 学 习 使 用 
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<select id="findAll" resultType="com.ay.model.AyUser"> 
select 
<include refid="userField"/> 
Erom av USer as a 

</select> 


</mapper> 

e <mapper/>: namespace 主 要 用 于 绑 定 Dao 接 口 ， 这 里 绑 定 com.ay.dao.AyUserDao 接 口 。 

e <select id="findAll">: select 标 签 ， 用 来 编写 select 查 询 语句 ，id 属 性 值 与 AyUserDao 接 
口中 的 方法 名 一 一 对 应 。 在 select 标 签 中 ， 查 询 了 ay_user 表 中 的 所 有 数据 ， 并 返回 .。 


到 这 里 ，Web 应 用 集成 Spring、Spring MVC、MyBatis 已 经 全 部 完成 ， 现 在 重新 启动 
Tomcat 服务 器 ， 在 浏览 器 输入 访问 地 址 : http://localhost:8080/user/findAll， 如 果 能 看 到 如 图 
2-10 和 图 2-11 所 示 的 信息 ， 代 表 整 合成 功 。 


| Debug 谨 tomcat8 


(入 Debugger Output ~»" 

Ee (x | © localhost:80807user/findAll | ee i 
CC 3 

党 应 用 党 百度 ， 兰 [搜索 】 兰 [CSDN] name: 阿 谢 

4 台 


name: 阿兰 


hello, ay 


图 2-10 浏览 器 输出 信息 图 2-11 控制 台 打 印信 息 


2.2.5 ”集成 Log4j 日 志 框 架 


Log4j 是 Apache 下 的 一 个 开源 项 目 ， 通 过 使 用 Log4j 可 以 将 日 志 信息 打印 到 控制 台 、 文 件 
等 。 也 可 以 控制 每 一 条 日 志 的 输出 格式 ， 通 过 定义 每 一 条 日 志 信息 的 级 别 ， 能 够 更 加 细致 地 控 
制 日 志 的 生成 过 程 。 
在 应 用 程序 中 添加 日 志 记 录 有 三 个 目的 : 
(1) 监视 代码 中 变量 的 变化 情况 ， 周 期 性 地 记录 到 文件 中 供 其 他 应 用 进行 统计 分 析 工作 。 
(2) 跟踪 代码 运行 时 轨迹 ， 作 为 日 后 审计 的 依据 。 
(3) 担当 集成 开发 环境 中 的 调试 器 的 作用 ， 向 文件 或 控制 台 打 印 代码 的 调试 信息 。 
Log4j 中 有 三 个 主要 的 组 件 ， 它 们 分 别 是 : Logger (记录 器 ) 、Appender (输出 端 ) 和 Layonut 
(布局 ) ， 这 三 个 组 件 可 以 简单 地 理解 为 日 志 类 别 , 日 志 要 输出 的 地 方 和 日 志 以 何 种 形式 输 
出 。Log4j 原理 如 图 2-12 所 示 。 


仅 供 非 商 业 用 途 或 交流 学 习 使 用 
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LoggerRepository 
Logger 的 容器 


ConsoleAppender FileAppender 


RollingFileAppender 


图 2-12 Log4j 日 志 框架 简单 原理 图 


e Logger( 记 录 器 ) : Logger 组 件 被 分 为 7 个 级 别 : all、debug、info、warn、error、fatal、 
off。 这 7 个 级 别 是 有 优先 级 的 : all<debug< info< warn< error< fatal<off， 分 别 用 来 指定 
这 条 日 志 信息 的 重要 程度 。Log4j 有 一 个 规则 : 只 输出 级 别 不 低 于 设 定 级 别 的 日 志 信 
息 。 假 设 Logger 级 别 设 定 为 Info， 则 info、warn、error 和 fatal 级 别 的 日 志 信 息 都 会 输 
出 ， 而 级 别 比 info 低 的 debug 则 不 会 输出 。Log4j 允 许 开 发 人 员 定 义 多 个 Logger， 每 个 
Logger 拥 有 自己 的 名 字 ，Logger 之 间 通 过 名 字 来 表明 隶属 关系 。 

e Appender (输出 端 ) : Log4j 日 志 系 统 允 许 把 日 志和 输出 到 不 同 的 地 方 ， 如 控制 台 

(Console ) 、 文 件 (Files ) 等 ， 可 以 根据 天 数 或 者 文件 大 小 产生 新 的 文件 ， 可 以 以 流 
的 形式 发 送 到 其 他 地 方 等 等 。 
e Layout( 布 局 ) : Layout 的 作用 是 控制 Log 信 息 的 输出 方式 ， 也 就 是 格式 化 输出 的 信息 。 


Log4j 支持 两 种 配置 文件 格式 ， 一 种 是 XML 格式 的 文件 ， 一 种 是 Java 特性 文件 
log4j2.properties 〈 键 = 值 ) ，properties 文件 简单 易 读 ， 而 XML 文件 可 以 配置 更 多 的 功能 ( 比 
如 过 滤 ) ， 没 有 好 坏 ， 能 够 融会 贯通 就 是 最 好 的 。 有 具体 的 XML 配置 如 下 所 示 : 


| 
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<?xml] version="1.0" encoding="UTF-8"?> 
<Configuration status="WARN"> 
<Appenders> 
<Console name="Console" target=”SYSTEM OUT™”> 
<PatternLayout pattern="%d{HH:mm:ss.SSS} [%t] %-S5level %logger{36} 
- %msggn" /> 
</Console> 
</Appenders> 
<Loggers> 
<Root level="debug"> 
<AppenderRef ref="Console" /> 
</Root> 
</Loggers> 
</Configuration> 


在 springmvc-mybatis-book 中 集成 Log4j2， 首 先 需要 在 pom.xml 文件 中 引入 所 需 的 依赖 ， 
具体 代码 如 下 : 


可 
<properties> 
// 省 略 部 分 代码 
<Ss1Lf4]j .version>1.7.7</slf4j .version> 
<1og4j .version>1.2.17</10g4j .version> 
</properties> 
<dependency> 
<groupId>1log4j</groupId> 
<artifactId>log4j</artifactId> 
<version>${10g4j .version}</version> 
</dependency> 
<dependency> 
<groupId>org.slf4j</groupId> 
<artifactId>slf4j-api</artifactId> 
<version>${slf4j .version}</version> 
</dependency> 
<dependency> 
<groupId>org.slf4j</groupId> 
<artifactId>slf4j-1l0g4j12</artifactId> 
<version>${slf4j .version}</version> 
</dependency> 
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e slf4j-api: 全 称 Simple Logging Facade For Java， 为 Java 提 供 的 简单 日 志 Facade。Facade 
门面 就 是 接口 ， 它 允许 用 户 以 自己 的 喜好 ， 在 项 目 中 通过 slfj 接 入 不 同 的 日 志 系统 。 
更 直观 一 点 ，slf4j 是 个 数据 线 ， 一 端 谋 入 程序 ， 另 一 端 链接 日 志 系 统 ， 从 而 实现 将 程 
序 中 的 信息 导入 到 上 日志 系统 并 记录 。 

e Slf4j-log4j12: 链接 slf4j- ee 配器 。 

e@ |og4j: 具体 的 日 志 系统 。 通 过 slfj-log4j12 初 始 化 log4j， 达 到 最 终日 志 的 输出 。 


slf4j-api、slf4j-log4j12 和 log4j 之 间 的 关系 如 图 2-13 所 示 。 


Application 应 用 


SLF4J API 《接口 ) 


图 2-13 ”slf4j-api、slf4j-log4j12 和 log4j 的 关系 描述 


集成 Log4j 的 依赖 包 添 加 完成 之 后 ， 在 项 目的 /src/main/java/resources/ 下 创建 配置 文件 
log4j.properties， 有 具体 代码 如 下 所 示 : 


###set log levels 
1og4j .rootLogger = DEBUG,Console 


### 输 出 到 控制 台 

1og4j .appender.Console=org.apache.10g4]j .ConsoleAppender 

1og4j .appender.Console.Target=System.out 

1og4j .appender.Console.layout=org.apache.1og4j.PatternLayout 

1og4j .appender.Console.layout.ConversionPattern= %d{ABSOLUTE} %5p Sc{1}:%L 
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在 log4j.properties 配置 文件 中 ， 设 置 了 日 志 级 别 和 将 日 志 输 出 到 控制 台 。 现 在 重新 启动 
springmvc-mybatis-book 项 目 ， 当 可 以 在 控制 台 看 到 相关 的 日 志 打 印信 息 时 ， 表 示 成 功 集 成 
Log4j 日 志 框 架 ， 有 具体 如 图 2-14 所 示 。 


DEBUG DefaultListableBeanFactory:2 Creating shared instance of singleftd 
DEBUG DefauliListableBeanFactory:467 Creating instance of bean ' ayUserDad 
DEBUG DefaultListableBeanFactory:5 Eagerly caching bean "ayUserDao” to 
DEBUG DefaultListableBeanFactory: Returning cached instance of singled 
DEBUG DefaultListableBeanFactory: - Invoking afterPropertiesSet() on bd 
DEBUG DefaultListableBeanFactory:5 Finished creating instance of bean 


DEBUG DefaultListableBeanFactory:5 Finished creating instance of bean 


DEBUG DefaultListableBeanFactory:5 Finished creating instance of bean 


DEBUG Default+lListableBeanFactory:: Creating shared instance of singletd 


图 2-14 控制 台 打 印 的 日 志 信息 


2.2.6 ”集成 JUnit 测试 框架 


JUnit 是 一 个 Java 语言 的 单元 测试 框架 。 它 由 Kent Beck 和 Erich Gamma 建立 ， 逐 渐 成 为 源 
于 Kent Beck 的 sUnit 的 xUnit 家 族 中 最 为 成 功 的 一 个 。JUnit 有 它 自 己 的 JUnit 扩展 生态 圈 ， 多 
数 Java 的 开发 环境 都 已 经 集成 了 JUnit 作为 单元 测试 的 工具 。 

JUnit 是 一 个 回归 测试 框架 (regression testing framework) 。JUnit 测试 是 程序 员 测试 ， 即 所 
谓 白 盒 测 试 ， 因 为 程序 员 知 道 被 测试 的 软件 如 何 〈How) 完成 功能 和 完成 什么 样 (What) 的 功 
能 。 由 于 JUnit 是 一 套 框架 ， 继 承 TestCase 类 ， 所 以 可 以 用 JUnit 进行 自动 测试 。 

在 springmvc-mybatis-book 项 目 中 集成 JUnit 测试 很 简单 ， 首 先 在 项 目的 pom.xml 配置 文件 
中 添加 相关 的 依赖 ， 有 具体 代码 如 下 : 


Se Une 

<dependency> 
<groupId>junit</groupId> 
<artifactId>Junit</artifactId> 
<version>4.12</version> 


</dependency> 

然后 ， 在 项 目的 /src/main/test/com.ay.test 目录 下 创建 测试 基 类 BaseJunit4Test， 具 体 代 码 如 
下 所 示 : 

/大 六 


* 描述 : 测试 基 类 

* @author RAY 

* Qcreate 2018/05/04 
**/ 
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QRunWith (SpringJUnit4ClassRunner.class) 
@ContextConfiguration(locations={"classpath:applicationContext.xml"}) 
public class BaseJunit4Test { 

} 

e。 @RunWith: 参数 化 运行 器 ， 用 于 指定 JUnit 运 行 环境 ， 是 JUnit 提 供给 其 他 框架 测试 环 
境 接 口 扩 展 ， 为 了 便于 使 用 Spring 的 依赖 注入 ，Spring 提 供 了 SpringJUnit4ClassRunner 
作为 JUnit 测 试 环 境 。 

e @ContextConfiguration: 加 载 配置 文件 applicationContext.xml。 


BaseJunit4Test 类 开发 完成 之 后 ， 在 /src/main/test/com.ay.test 目录 下 创建 AyUserDaoTest 测 
试 类 简单 测试 集成 Junit 框架 是 否 成 功 ， 具 体 代 码 如 下 : 


/** 

* 描述 : 用 户 DAO 测试 类 

* @author Ay 

* @create 2018/05/04 

xx/ 

public class AyUserDaoTest extends BaseJunit4Test!{ 


@Resource 
private AyUserDao ayUserDao; 


@Test 
public void testFindAll(){ 
List<AyUser> userList = ayUserDao.findAl]l (); 


System.out .println (userList.size()); 


} 


AyUserDaoTest 类 需要 继承 BaseJunit4Test 测试 基 类 。AyUserDaoTest 类 代码 开发 完成 之 
后 ， 运 行 testFindAll 方 法， 便 可 以 在 控制 台 看 到 相关 的 打印 信息 。 


Spring 快速 上 手 


本 章 主要 回顾 Spring 的 基础 知识 IOC 和 AOP、IOC 和 AOP 背后 的 实现 原理 和 设计 模式 。 
这 些 设 计 模 式 包括 单 例 模 式 、 简 单 工厂 模式 、 工 厂 方法 模式 和 动态 代理 模式 等 。 


3.1 Spring IDC 和 DI 


3.1.1 Spring IOC 和 DI 概述 


学 习 Spring， 经 常会 联系 到 Spring 的 IOC (控制 反 转 ) 和 DI (依赖 注入 ) 。 在 Spring 环境 
下 这 两 个 概念 是 等 同 的 ， 控 制 反 转 是 通过 依赖 注入 来 实现 的 。 

IOC 是 指 原先 我 们 代码 里 面 需要 实现 的 对 象 创建 、 维 护 对 象 间 的 依赖 关系 ， 反 转 给 容器 来 
帮忙 实现 。 那 么 必然 的 我 们 需要 创建 一 个 容器 ， 同 时 需要 一 种 描述 来 让 容器 知道 需要 创建 的 对 
象 与 对 象 的 关系 。 依 赖 注 入 的 目的 是 为 了 解 耦 ， 体 现 一 种 “组 合 ”的 理念 。 继 承 一 个 父 类 ， 子 
类 将 与 父 类 耦合 ， 组 合 关系 使 耦合 度 大 大 降低 。 

Spring IOC 容器 负责 创建 Bean， 并 通过 容器 将 Bean 注入 到 需要 的 Bean 对 象 上 。 同 时 
Spring IOC 容器 还 负责 维护 Bean 对 象 与 Bean 对 象 之 间 的 关系 。 那 么 ,Spring IOC 如 何 来 体现 对 
象 与 对 象 之 间 的 关系 呢 ? Spring 提供 了 XML 配置 和 Java 配置 等 方式 ， 具 体 看 下 面 的 实例 : 


非 卖 品 ， 仅 供 非 商业 用 途 或 交流 学 习 使 用 
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@Service 
public class AyUserServiceImpl implements AyUserServicel{ 


@Resource 
private AyUserDao ayUserDao; 


public List<AyUser> findAll() 1{ 
return ayUserDao.findAll(); 
} 
} 


Spring 提供 的 注解 有 很 多 ， 比 如 声明 Bean 的 注解 和 注入 Bean 的 注解 ， 这 些 注解 在 工作 中 
经 常 被 使 用 ， 所 以 有 必要 在 这 里 重新 回顾 一 下 。 

声明 Bean 的 注解 : 

e @Component 没有 明确 的 角色 。 

e @Service 在 服务 层 (业务 逻辑 层 ) 被 使 用 。 

e @Repository 在 数据 访问 层 (dao 层 ) 被 使 用 。 

e @Controller 在 表现 层 (控制 层 ) 被 使 用 。 


注入 Bean 的 注解 : 


e @Autowired Spring 提供 的 注解 。 
e @Resource JSR-250 提 供 的 注解 。 


注意 ，@Resource 这 个 注解 属于 J2EE 的 ， 默 认 安 照 名 称 进 行 装配 ， 名 称 可 以 通过 name 属 
性 进行 指定 。 如 果 没 有 指定 name 属性 ， 当 注解 写 在 字段 上 时 ， 默 认 取 字段 名 进行 查找 。 如 果 
注解 写 在 setter 方法 上 默认 取 属 性 名 进行 装配 。 当 找 不 到 与 名 称 匹 配 的 bean 时 才 按 照 类 型 进行 
装配 。 但 是 需要 注意 的 是 ， 如 果 name 属性 一 旦 指定 ， 就 只 会 按照 名 称 进行 装配 。 有 具体 代码 
如 下 : 


@Resource (name = "ayUserDao") 
private AyUserDao ayUserDao; 


而 @Autowired 这 个 注解 是 属于 Spring 的 ， 默 认 按 类 型 装配 。 默 认 情况 下 要 求 依赖 对 象 必须 存 
在 ， 如 果 要 允许 null 值 ， 可 以 设置 它 的 required 属性 为 false， 如 : @Autowired(required=false)， 如 
果 我 们 想 使 用 名 称 装 配 ， 可 以 结合 @Qualifier 注解 进行 使 用 。 具 体 代 码 如 下 : 

@Autowired 


@QOualifier ("ayUserDao") 
private AyUserDao ayUserDao; 


非 卖 品 ， 仅 供 非 商业 用 途 或 交流 学 习 使 用 
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3.1.2 ” 单 例 模式 


Spring 依赖 注入 Bean 实例 默认 都 是 单 例 的 ， 所 以 有 必要 来 回顾 一 下 单 例 模式 。 
对 于 一 个 软件 系统 的 某 些 类 而 言 ， 无 须 创 建 多 个 实例 , 例如 Windows 任务 管理 器 , 如 图 3-1 
所 示 。 


进程 性 船 应 用 历史 记录 启动 用 户 详细 信息 报 务 


入 


CPU Intel(R) Core(TM) i7-6700HQ CPU @ 2.60GHz 
和 % 科 用 济 100% 


R | 33% 1.41 GHz 
A 


时 6.0/15.9 GB (38%) 


“| 磁盘 0 (C:) 
i 0% 


一 磁盘 1 (D: E: F: 
i ,0% 


33% 1.41 GHz 


en 204 2450 79961 于 人 


(人 ) 简略 信息 ftD) ， 代 )》 打开 次 源 监 祝 束 


3-1 Window 任务 管理 器 


我 们 没 办 法 打开 多 个 任务 管理 器 ， 也 就 是 说 ， 在 一 个 Windows 系统 中 ， 任 务 管理 器 存在 唯 
一 性 。 为 什么 要 这 样 设计 呢 ? 可 以 从 以 下 两 个 方面 来 分 析 : 其 一 ， 如 果 能 弹出 多 个 窗口 ， 且 这 
些 窗口 的 内 容 完 全 一 致 ， 全 部 是 重复 对 象 ， 势 必 会 浪费 系统 资源 ， 任 务 管理 器 需要 获取 系统 运 
行 时 的 诸多 信息 ， 这 些 信息 的 获取 需要 消耗 一 定 的 系统 资源 ， 包 括 CPU 资源 及 内 存 资 源 等 ， 浪 
费 是 可 耻 的 ， 而 且 根本 没有 必要 显示 多 个 内 容 完 全 相同 的 窗口 ， 其 二 ， 如 果 弹 出 的 多 个 窗口 内 
容 不 一 致 ， 问 题 就 更 加 严重 了 ， 这 意味 着 在 某 一 瞬间 系统 资源 使 用 情况 和 进程 、 服 务 等 信息 存 
在 多 个 状态 ， 例 如 任务 管理 器 窗口 A 显示 “CPU 使 用 率 ”为 10%， 窗 口 B 显示 “CPU 使 用 率 ” 
为 15%， 到 底 哪 个 才 是 真实 的 呢 ? 这 纯 属 “调戏 ”用 户 ， 给 用 户 带 来 误解 ， 更 不 可 取 。 由 此 可 
见 ， 确 保 Windows 任务 管理 器 在 系统 中 有 且 仅 有 一 个 非常 重要 。 除 了 任务 管理 器 外 ， 数 据 库 连 
接 池 、 应 用 配置 等 都 是 使 用 单 例 的 。 

了 解 完 单 例 模式 的 使 用 场景 后 ， 再 来 看 看 单 例 模式 的 定义 。 

。 单 例 模式 (Singleton Pattern) : 确保 菜 一 个 类 只 有 一 个 实例 ， 而 且 自 行 实例 化 并 向 整 

个 系统 提供 这 个 实例 ， 这 个 类 称 为 单 例 类 ， 它 提供 全 局 访问 的 方法 。 单 例 模 式 是 一 种 
对 象 创建 型 模式 。 


非 卖 品 ， 仅 供 非 商业 用 途 或 交流 学 习 使 用 
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先 来 看 一 个 传统 的 创建 类 的 代码 : 


/** 

* 描述 : 传统 创建 类 实例 
* Qauthor RAY 

* QQcreate 2018/1/23. 
*/ 


DUDLLICeEelasse Case lt 


public static void main(String[] args) { 
Singleton singleton = new Singleton (); 
Singleton singleton2 = new Singleton () ; 


l: 


/** 
* 描述 : 单 例 类 
ek 


class Singleton!{ 


} 


上 述 代码 中 ， 每 次 new Singleton()， 都 会 创建 一 个 Singleton 实例 ， 显 然 不 符合 一 个 类 只 有 
一 个 实例 的 要 求 。 所 以 需要 对 上 述 代码 进行 修改 ， 具 体 修改 点 如 下 : 


/** 

* 描述 : 单 例 模式 实例 

* Qauthor Ay 

* @create 2018/1/23. 

人 

EUolcesclLass Case Tl 

public static void maln(Stringll args) | 

//Singleton singleton = new Singleton(); 
// 单 例 


Singleton singleton = Singleton.getInstance(); 


} 


/** 

* 描述 : 单 例 类 《〈 饿 汉 模 式 ) 
a/ 

class Singletont{ 


非 卖 品 ， 仅 供 非 商 业 用 途 或 交流 学 习 使 用 


44 | Spring MVC + MyBatis 快速 开发 与 项 目 实战 


//step 2. 自行 对 外 提供 实例 
private static final Singleton singleton = new Singleton(); 
//step 1. 构 造 函 数 私有 化 
private Singleton(){} 
//step 3. 提供 外 界 可 以 获得 该 实例 的 方法 
public static Singleton getInstance(){ 
return singleton; 
} 
} 


单 例 模式 的 写法 有 很 多 种 ， 上 述 代码 是 一 个 最 简单 的 饿 汉 模 式 的 实现 方法 ， 在 类 加 载 的 时 
候 就 创建 了 单 例 类 的 对 象 。 由 上 述 代码 可 知 ， 实 现 一 个 单 例 模式 总 共有 三 个 步 又: 

(1) 构造 函数 私有 化 。 

(2) 自行 对 外 提供 实例 。 

(3) 提供 外 界 可 以 获得 该 实例 的 方法 。 


与 饿 汉 模 式 相 对 应 的 还 有 懒汉 模式 ， 懒 汉 模式 有 延迟 加 载 的 意思 ， 有 具体 代码 如 下 : 
/** 
* 描述 :懒汉 模式 (存在 多 线程 并 发 的 问题 ， 不 是 正确 的 写法 ) 
* Qauthor RAY 
* @create 2018/04/14 
ll 
class Singletont{ 
private static Singleton singleton = null; 
private Singleton(){} 
public static Singleton getIinstance(){ 
//1 .判断 对 象 是 否 创建 
if(null == singleton){ 
//2 .创建 对 象 
singleton = new Singleton(); 
} 


return singleton; 


} 

如 果 创 建 单 例 对 象 会 消耗 大 量 资源 ， 那 么 延迟 创建 对 象 是 一 个 不 错 的 选择 ， 但 是 懒汉 模式 
有 一 个 明显 的 问题 ， 就 是 没有 考虑 线程 安全 问题 ， 在 多 线程 并 发 的 情况 下 ， 会 并 发 调用 
getInstance() 方 法 ， 从 而 导致 系统 同时 创建 多 个 单 例 类 实例 ， 显 然 不 符合 要 求 。 可 以 通过 给 
getInstance() 方 法 添加 锁 解 决 该 问题 ， 具 体 代 码 如 下 : 


A 
仅 供 非 商 业 用 途 或 交流 学 习 使 用 wy 


非 卖 品 ， 仅 供 非 商业 用 途 或 交流 学 习 使 用 
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/** 
* 描述 : 懒汉 模式 (添加 synchronized 锁 ) 
* Qauthor Ay 
* @create 2018/04/14 
oy 
class Singletont{ 
private static Singleton singleton = null; 
private Singleton(){} 
public static synchronized Singleton getInstance () { 
//1 .判断 对 象 是 否 创建 
if(null == Singleton) { 
//2 .创建 对 象 
singleton = new Singleton() ; 
} 


return singleton; 


} 


添加 synchronized 锁 虽 然 可 以 保证 线程 安全 ， 但 是 每 次 访问 getInstance() 方 法 的 时 候 ， 都 会 
有 加 锁 和 解锁 操作 ， 同 时 synchronized 锁 是 添加 在 方法 上 面 ， 锁 的 范围 过 大 ， 而 单 例 类 是 全 局 
唯一 的 ， 锁 的 操作 会 成 为 系统 的 瓶颈 。 因 此 ， 需 要 对 代码 再 进行 优化 ， 由 此 引出 了 “双重 校 验 
锁 ” 的 方式 ， 有 具体 代码 如 下 : 


/** 
* 描述 : 双重 校 验 锁 (指令 重 排 问 题 ) 
* Qauthor Ay 
* @create 2018/04/14 
wh 
class Singletont 
private static Singleton singleton = null; 
private Singleton(){} 
public static Singleton getInstance () { 
// 第 一 次 校 验 
if(singleton == DulI) { 
synchronized(Singleton.class){ 
// 第 二 次 检验 
if(singleton == null){ 
// 创 建 对 象 ， 非 原子 操作 


singleton = new Singleton(); 


仅 供 非 商 业 用 途 或 交流 学 习 使 用 


非 卖 品 ， 仅 供 非 商 业 用 途 或 交流 学 习 使 用 
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} 


return singleton; 


} 


双重 校 验 锁 会 出 现 指 令 重 排 的 问题 ， 所 谓 指 令 重 排 是 指 JVM 为 了 优化 指令 ， 提 高 程序 运行 
效率 ， 在 不 影响 单线 程 程序 执行 结果 的 前 提 下 ， 尽 可 能 地 提高 并 行 度 。singleton = new 
Singleton() 看 似 原子 操作 ， 其 实 不 然 ，singleton = new Singleton() 实 际 上 可 以 抽象 为 下 面 几 条 
JVM 指令 : 

//1: 分 配对 象 的 内 存 空间 

memory = allocate() 

//2: 初始 化 对 象 

ctorInstance (memory); 

//3: 设置 instance 指向 刚 分 配 的 内 存 地 址 


singleton = memory; 


上 面 操作 2 依赖 于 操作 1， 但 是 操作 3 并 不 依赖 于 操作 2， 所 以 JVM 是 可 以 针对 它们 进行 
前 令 的 优化 重 排序 的 ， 经 过 重 排序 后 如 下 ; 


//1: 分 配对 象 的 内 存 空 间 

memory = allocate(); 

//3: instance 指向 刚 分 配 的 内 存 地 址 ， 此 时 对 象 还 未 初始 化 
singleton = memory; 

//2: 初始 化 对 象 


ctorIinstance (memory); 


可 以 看 到 ， 指 令 重 排 之 后 ，singleton 指向 分 配 好 的 内 存放 在 了 前 面 ， 而 这 段 内 存 的 初始 化 
被 排 在 了 后 面 。 在 线程 A 执行 这 段 赋值 语句 ， 在 初始 化 分 配对 象 之 前 就 已 经 将 其 赋值 给 
singleton 引用 ， 恰 好 B 线程 进入 方法 判断 singleton 引用 不 为 null， 然 后 就 将 其 返回 使 用 ， 导 致 
程序 出 错 。 

为 了 解决 指令 重 排 的 问题 ， 可 以 使 用 volatile 关键 字 修 饰 singleton 字段 。volatile 关键 字 的 
一 个 语义 就 是 禁止 指令 的 重 排序 优化 ， 阻 止 JVM 对 其 相关 代码 进行 指令 重 排 ， 这 样 就 能 够 按照 
既定 的 顺序 指令 执行 。 修 改 后 的 代码 如 下 : 

/大 大 

* 描述 : 双重 校 验 锁 (volatile 解决 指令 重 排 问题 ) 
* @author Ay 

* @create 2018/04/14 

a 


class Singletont{ 


仅 供 非 商 业 用 途 或 交流 学 习 使 用 LD 


j 途 或 交流 学 习 使 用 


非 卖 品 ， 仅 供 非 商 业 上 
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Private static volatile Singleton singleton = null; 


private Singleton(){} 
public static Singleton getIinstance(){ 
if(singleton == null)f{ 
synchronized(Singleton.class)t{ 
if(singleton == null){ 
singleton = new Singleton(); 


} 


return singleton; 


; 


除了 双重 校 验 锁 的 写法 外 ， 比 较 推 荐 读者 使 用 最 后 一 种 单 例 模 式 的 写法 : 静态 内 部 类 的 单 


例 模 式 ， 具 体 代码 如 下 : 
/交火 
* 描述 静态 内 部 类 单 例 模式 (推荐 的 写法 ) 
* Qauthor RAY 
* @create 2018/04/14 
wu 


class Singletont{ 


//2: 私有 的 静态 内 部 类 ， 类 加 载 器 负责 加 锁 


private static class SingletonHolder{ 


private static Singleton singleton = new 


} 

//1 :私有 化 构造 方法 

private ~ Singleton() ty} 

//3: 自 行 对 外 提供 实例 

public static Singleton getinstancel()! 
return SingletonHolder.singleton; 


} 


Singleton(); 


当 第 一 次 访问 类 中 的 静态 字段 时 ， 会 触发 类 加 载 ， 并 且 同 一 个 类 只 加 载 一 次 。 静 态 内 部 类 
也 是 如 此 ， 类 加 载 过 程 由 类 加 载 器 负责 加 锁 ， 从 而 保证 线程 安全 。 这 种 写法 相对 于 双重 检验 锁 


的 写法 ， 更 加 简洁 明了 ， 也 更 加 不 会 出 错 。 


仅 供 非 商业 用 途 或 交流 学 习 使 


非 卖 品 ， 仅 供 非 商 业 用 途 或 交流 学 习 使 | 
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3.1.3 Spring 单 例 模式 源码 解析 


回顾 完 单 例 模式 的 内 容 ， 来 看 一 下 Spring 的 BeanFactory 工厂 如 何 实 现 单 例 模式 。Spring 
的 依赖 注入 (包括 lazy-init 方式 ) 都 是 发 生 在 AbstractBeanFactory 的 getBean 方法 里 。getBean 
方法 内 部 调用 doGetBean 方法 ，doGetBean 方法 调用 getSingleton 方法 进行 bean 的 创建 。 非 
lazy-init 方 式 ， 在 容器 初始 化 时 进行 调用 ，lazy-init 方式 ， 在 用 户 向 容器 第 一 次 索要 bean 时 进行 
调用 。AbstractBeanFactory 类 源码 具体 如 下 : 


// 省 略 代 码 

@Override 

public Object getBean(String name) throws BeansException { 
return doGetBean (name, nul]l, null, false); 


protected <T> T doGetBean (final String name, @Nullable final Class<T> 
requiredType,@Nullable final Object[] args, 
boolean typeCheckOonly) throws BeansException { 


final String beanName = transformedBeanName (name); 


Object bean; 


// Eagerly check singleton cache for manually registered singletons. 
Object sharedinstance = getSingleton (beanName); 
// 省 略 代码 
} 
@Nullable 
protected Object getSingleton (String beanName, boolean allowEarlyReference) { 
Object singletonObject = this.singletonObjects.get (beanName); 
if (singletonObject == null && isSingletonCurrentlyIinCreation 
(beanName)) { 
synchronized (this.singletonObjects) { 
singletonObject = this.earlySingletonObjects.get (beanName); 
if (singletonObject == null && allowEarlyReference) { 
ObjectFactory<?> singletonFactory 
= this.singletonFactories.get (beanName); 
if (singletonFactory != null) { 
singletonObject = singletonFactory.getObject () : 
this.earlySingletonObjects.put (beanName, 
singletonObject); 


仅 供 非 商业 用 途 或 交流 学 习 使 用 节 
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this.singletonFactories.remove (beanName) 


} 


return singletonObject; 


} 


从 上 面 代码 中 可 以 看 到 ，Spring 依赖 注入 时 ， 使 用 了 双重 校 验 锁 的 单 例 模式 。 首 先 从 缓存 
singletonObjects (实际 上 是 一 个 ConcurrentHashMap) 中 获取 bean 实例 ， 如 果 为 null， 对 缓存 
singletonObjects 加 锁 ， 然 后 再 从 缓存 earlySingletonObjects( 实 际 上 是 一 个 HashMap ) 中 获取 bean 
实例 ， 如 果 继 续 为 null， 就 创建 一 个 bean。 在 这 里 Spring 并 没有 使 用 私有 构造 方法 来 创建 
bean， 而 是 通过 singletonFactory.getObject() 返回 具体 beanName 对 应 的 ObjectFactory 来 创建 
bean 。 一 路 跟踪 下 去 ， 发 现实 际 上 是 调用 了 AbstractAutowireCapableBeanFactory 的 
doCreateBean 方法 ， 返 回 了 BeanWrapper 包装 并 创建 的 bean 实例 。 
AbstractAutowireCapableBeanFactory 的 doCreateBean 方法 部 分 代码 如 下 : 


protected Object doCcreateBean (final String beanName, 

final RootBeanDefinition mbd,final @Nullable Object[] args) 

throws BeanCreationException { 
// Instantiate the bean. 
BeanWrapper instanceWrapper = nuill; 
if (mbd.isSingleton()) { 

instanceWrapper = this.factoryBeanInstanceCache.remove (beanName); 
} 
if (instanceWrapper == null) { 

// 创 建 bean 实例 ， 并 返回 instanceWrapper 

instanceWrapper = createBeanInstance (beanName, mbd, args); 
} 
final Object bean = instanceWrapper.getWrappedIinstance()，; 
Class<?> beanType = instanceWrapper.getWrappedClass () ， 
if (beanType != NullBean.class) { 

mbd.resolvedTargetType = beanType; 
} 
// Allow post-processors to modify the merged bean definition. 
synchronized (mbd.postProcessingLock) { 

if (!mbd.postProcessed) { 

Cy 
applyMergedBeanDefinitionPostProcessors (mbd, 


beanType, beanName); 


仅 供 非 商业 用 途 或 交流 学 习 使 用 
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} 

catch (Throwable ex) { 

throw new BeanCreationException 
(mbd.getResourceDescription(),beanName, 
"Post-processing of merged bean definition failed", ex); 

} 

mbd.postProcessed = true; 


// Eagerly cache singletons to be able to resolve circular references 
// even when triggered by lifecycle interfaces like BeanFactoryAware. 
boolean earlySingletonExposure = (mbd.isSingleton() && 
this.allowCircularReferences && 
isSingletonCurrentlyIinCreation (beanName)); 
if (earlySingletonExposure) { 
if (logger.isDebugEnabled()) { 
logger.debug ("Eagerly caching bean '" + beanName + 
"' to allow for resolving potential circular references" ) 
} 
// 增 加 beanName 和 ObjectFactory 的 键 值 对 应 关系 
// 获 取 bean 的 所 有 后 处 理 器 ， 并 进行 处 理 
addSingletonFactory (beanName, () -> 
getEarlyBeanReference (beanName, mbd, bean)); 


// 省 略 大 量 代码 


} 


createBeanlnstance(beanName, mbd, args): 创建 bean 实 例 并 返回 instanceWrapper。 
addSingletonFactory: 增加 beanName 和 ObjectFactory 的 键 值 对 应 关系 。 
getEarlyBeanReference(beanName, mbd，bean): 获取 bean 的 所 有 后 处 理 器 ， 并 进行 
处 理 。 如 果 是 SmartInstantiationAwareBeanPostProcessor 类 型 ， 就 进行 处 理 ， 如 果 没 有 
相关 处 理 内 容 ， 就 返回 默认 的 实现 。 


仅 供 非 商业 用 途 或 交流 学 习 使 用 
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getEarlyBeanReference 的 具体 代码 如 下 : 


protected Object getEarlyBeanReference (String beanName, 
RootBeanDefinition mbd, Object bean) { 
Object exposedObject = bean; 
if (!Imbd.isSynthetic() && hasInstantiationAwareBeanPostProcessors () ) { 
for (BeanPostProcessor bp “= getBeanBostProcessors() ) 
if (bp instanceof SmartIinstantiationAwareBeanPostProcessor){ 
SmartIinstantiationAwareBeanPostProcessor ibp 
= (SmartIinstantiationAwareBeanPostProcessor) bp; 
exposedObject 
= ibp.getEarlyBeanReference (exposedObject, beanName); 


) 
} 


return exposedObject; 


} 

3.1.4 简单 工厂 模式 详解 

Spring 的 Bean 工厂 大 量 使 用 工厂 方法 模式 ， 而 工厂 方法 模式 是 以 简单 工厂 模式 为 基础 的 ， 
所 以 有 必要 先 来 回顾 下 简单 工厂 模式 的 基础 知识 。 

简单 工厂 模式 〈Simple Factory Pattern) 用 来 定义 一 个 工厂 类 ， 它 可 以 根据 参数 的 不 同 返 回 
不 同类 的 实例 ， 被 创建 的 实例 通常 都 具有 共同 的 父 类 。 因 为 在 简单 工厂 模式 中 用 于 创建 实例 的 
方法 是 静态 (static) 方法 ， 因 此 简单 工厂 模式 又 被 称 为 静态 工厂 方法 〈Static Factory Method ) 
模式 ， 它 属于 类 创建 型 模式 。 

简单 工厂 模式 的 要 点 在 于 ， 当 你 需要 什么 ， 只 需要 传 入 一 个 正确 的 参数 ， 就 可 以 获取 你 所 
需要 的 对 象 ， 而 无 须知 道 其 创建 细节 。 简 单 工 厂 模式 结构 比较 简单 ， 其 核心 是 工厂 类 的 设计 ， 
其 结构 如 图 3-2 所 示 。 

在 简单 工厂 模式 结构 图 中 包含 如 下 几 个 角色 。 


e@ Factory (工厂 角色 ) : 工厂 角色 即 工厂 类 ， 它 是 简单 工厂 模式 的 核心 ， 负 责 实现 创建 
所 有 产品 实例 的 内 部 逻辑 ; 工厂 类 可 以 被 外 界 直 接 调用 ， 创 建 所 需 的 产品 对 象 ; 在 工 
厂 类 中 提供 了 静态 的 工厂 方法 factoryMethod()， 它 的 返回 类 型 为 抽象 产品 类 型 
Product, 

e Product (抽象 产品 角色 ) : 它 是 工厂 类 所 创建 的 所 有 对 象 的 父 类 ， 封 装 了 各 种 产品 对 
象 的 公有 方法 ， 它 的 引入 将 提高 系统 的 灵活 性 ， 使 得 在 工厂 类 中 只 需 定义 一 个 通用 的 
工厂 方法 ， 因 为 所 有 创建 的 具体 产品 对 象 都 是 其 子 类 对 象 。 


仅 供 非 商业 用 途 或 交流 学 习 使 用 
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| Product 《 搜 象 类 》 
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Ci :pe 
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Concreteproduct( 且 体 类 1) Ee 具体 类 


re 


4 


i (TF) 
图 3-2 简单 工厂 模式 结构 图 


e ConcreteProduct (具体 产品 角色 ) : 它 是 简单 工厂 模式 的 创建 目标 , .所 有 被 创建 的 对 
象 都 充当 这 个 角色 的 某 个 具体 类 的 实例 。 每 一 个 具体 产品 角色 都 继承 了 抽象 产品 角 
色 ， 需 要 实现 在 抽象 产品 中 声明 的 抽象 方法 。 


来 看 一 个 简单 工厂 模式 的 例子 : 


/** 

* 描述 : 交通 工具 《〈 简 单 工 三 模式 ) 

* Qauthor Ay 

* @create 2018/1/19. 

wf 

public class SimpleFactoryPattern { 


public static void main(Stringl[| args) { 
// 根 据 需 要 传 入 相关 的 交通 工具 名 称 ， 获 取 交 通 工具 实例 
Vehicle Vehicle = Factory.produce ("car"); 
vehicle.run()，; 


} 

/** 

* 工厂 类 
A 


class Factoryt{ 
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/静态 方法 ， 生 产 交 通 工 具 
public static Vehicle produce(String type){ 
Vehicle vehicle = null; 
if(type.equals ("car")){ 
Vehicle DeweCa (7 
return Vehicle'; 
} 
if(type.equals ("bus"))t{ 
Vehicle = new SBus'() 
return vehicle; 
} 
if(type.equals ("bicycle"))t{ 
vehicle — new piecyclel(), 
return vehicle; 
} 


return vehicle; 


/** 
* 交通 工具 (抽象 类 ) 
“7 


interface Vehiclel 


AoEie lo bh 0) 


/** 
* 汽车 (具体 类 ) 
< 


class Car implements Vehiclet 


@Override 
Bub vo ni() 
System ou rnt ln (ar Tn) 


/** 
* 公交 车 (具体 类 ) 
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将 
三 


*/ 

class Bus implements Vehiclet 
QOverride 
Public void run() { 


SySstemaoUuUb DEINn (UOuS On 
} 
} 
/** 
* 目 行 车 (具体 类 ) 
0 


class Bicycle implements Vehicleli 
QOverride 
Publne veal run (el! 


SvSstem Out .println (VDLCvVele run ,0 ) 


} 


上 述 代码 中 ， 交 通 工 具 都 被 抽象 为 Vehicle 类 ， 而 Car、Bus、Bicycle 类 是 Vehicle 类 的 实 
现 类 ， 并 实现 Vehicle 的 run 方法 ， 打 印 相 关 的 信息 。Factory 是 工厂 类 ， 类 中 的 静态 方法 
produce 根据 传 入 的 不 同 的 交通 工具 的 类 型 ， 生 产 相 关 的 交通 工具 ， 返 回 抽象 产品 类 Vehicle。 
上 述 代码 的 类 结构 如 图 3-3 所 示 。 


Car (汽车 } Bicycle《 自 行车) Bus 《公交 车 》 
> | SE 


Es ] 


图 3-3 汽车 与 工厂 类 结构 图 
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简单 工厂 模式 的 主要 优点 如 下 : 


(1) 工厂 类 包含 必要 的 判断 逻辑 ， 可 以 决定 在 什么 时 候 创 建 哪 一 个 产品 类 的 实例 ， 客 户 端 
可 以 免除 直接 创建 产品 对 象 的 职责 ， 而 仅仅 “消费 ”产品 ， 简 单 工厂 模式 实现 了 对 象 创建 和 使 
用 的 分 离 。 

(2) 客户 端 无 须知 道 所 创建 的 具体 产品 类 的 类 名 ， 只 需要 知道 具体 产品 类 所 对 应 的 参数 即 
可 ， 对 于 一 些 复杂 的 类 名 ， 通 过 简单 工厂 模式 可 以 在 一 定 程度 减少 使 用 者 的 记忆 量 。 


简单 工厂 模式 的 主要 缺点 如 下 : 

(1) 由 于 工厂 类 集中 了 所 有 产品 的 创建 逻辑 ， 职 责 过 重 ， 一 旦 不 能 正常 工作 ， 整 个 系统 都 
会 受到 影响 。 

(2) 使 用 简单 工厂 模式 势必 会 增加 系统 中 类 的 个 数 〈 引 入 了 新 的 工厂 类 ) ， 增 加 了 系统 的 
复杂 度 和 理解 难度 。 


(3) 系统 扩展 困难 ， 一 旦 添加 新 产品 就 不 得 不 修改 工厂 逻辑 ， 在 产品 类 型 较 多 时 ， 有 可 能 
造成 工厂 逻辑 过 于 复杂 ， 不 利于 系统 的 扩展 和 维护 。 

(4) 简单 工厂 模式 由 于 使 用 了 静态 工厂 方法 ， 造 成 工厂 角色 无 法 形成 基于 继承 的 等 级 
结构 。 


3.1.5 ”工矿 方法 模式 详解 


在 简单 工厂 模式 中 只 提供 一 个 工厂 类 ， 它 需要 知道 每 一 个 产品 对 象 的 创建 细节 ， 并 决定 何 
时 实例 化 哪 一 个 产品 类 。 简 单 工厂 模式 最 大 的 缺点 是 当 有 新 产品 要 加 入 到 系统 中 时 ， 必 须 修改 
工厂 类 ， 需 要 在 其 中 加 入 必要 的 业务 逻辑 ， 这 违背 了 “ 开 财 原则 ”。 此 外 ， 在 简单 工厂 模式 
中 ， 所 有 的 产品 都 由 同一 个 工厂 创建 ， 工 厂 类 职责 较 重 ， 业 务 逻 辑 较 为 复杂 ， 具 体 产 品 与 工厂 
类 之 间 的 耦合 度 高 ， 严 重 影响 了 系统 的 灵活 性 和 扩展 性 ， 而 工矿 方法 模式 则 可 以 很 好 地 解决 这 
一 问题 。 

在 工厂 方法 模式 中 ， 不 再 提供 一 个 统一 的 工厂 类 来 创建 所 有 的 产品 对 象 ， 而 是 针对 不 同 的 
产品 提供 不 同 的 工厂 ， 系 统 提 供 一 个 与 产品 等 级 结构 对 应 的 工厂 等 级 结构 。 

工厂 方法 模式 的 定义 : 工厂 方法 模式 (Factory Method Pattern ) 用 来 定义 一 个 用 于 创建 对 象 
的 接口 ， 让 子 类 决定 将 哪 一 个 类 实例 化 。 工 厂 方法 模式 让 一 个 类 的 实例 化 延迟 到 其 子 类 。 工 厂 
方法 模式 又 简称 为 工厂 模式 (Factory Pattern) ， 还 可 称 作 虚拟 构造 器 模式 (Virtual Constructor 
Pattern) 或 多 态 工厂 模式 (Polymorphic Factory Pattern) 。 工 厂 方法 模式 是 一 种 类 创建 型 模式 。 

工厂 方法 模式 提供 一 个 抽象 工厂 接口 来 声明 抽象 工厂 方法 ， 而 由 其 子 类 来 具体 实现 工厂 方 
法 ， 创 建 具 体 的 产品 对 象 。 工 厂 方法 模式 结构 如 图 3-4 所 示 。 
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Product《 抽 象 产品 类 ) | Factory《〈 抽 象 工厂 类 )》 
ER ssessss 
<、 V 这 < | V > 
ConcretepProduct { 县 笨 产 品类 1) Es 《具体 产品 类 2) | Concreteractory (具体 工厂 1) | |concreteFactory 《具体 工厂 2》 | 


wig et 


图 3-4 工厂 方法 模式 类 结构 图 

在 工厂 方法 模式 结构 图 中 包含 如 下 几 个 角色 。 

e Product( 抽 象 产 品类 ): 它 是 定义 产品 的 接口 ， 是 工厂 方法 模式 所 创建 对 象 的 超 类 型 ， 
也 就 是 产品 对 象 的 公共 父 类 。 

e ConcreteProduct (具体 产品 类 ) : 它 实 现 了 抽象 产品 接口 ， 某 种 类 型 的 具体 产品 由 专 
门 的 具体 工厂 创建 ， 具 体 工厂 和 具体 产品 之 间 一 一 对 应 。 

e Factory (抽象 工厂 类 ) : 在 抽象 工厂 类 中 ， 声 明了 工厂 方法 (Factory Method ) ， 用 于 返回 
一 个 产品 。 抽 和 象 工厂 是 工厂 方法 模式 的 核心 ， 所 有 创建 对 象 的 工厂 类 都 必须 实现 该 接口 。 

e ConcreteFactory〈 具 体 工 厂 类 ) : 它 是 抽象 工厂 类 的 子 类 ， 实 现 了 抽象 工厂 中 定义 的 
工厂 方法 ， 并 可 由 客户 端 调用 ， 返 回 一 个 具体 产品 类 的 实例 。 


下 面 来 看 一 个 汽车 与 工厂 实例 ， 具 体 代码 如 下 : 


/x** 

* 描述 ; 汽车 与 工厂 (工矿 方 法 模式 ) 

* Qauthor RAY 

* @create 2018/1/19. 

0/ 

public class FactoryMethodPattern { 

public static void main(String[] args) throws Exception { 

1 Si 
Ractory carFactory = new CarFactory(); 
Vehicle car = carFactory.produce(); 
Car run(), 
公交 全 
Factory busFactory = new BusFactory(); 
Vehicle bus = busFactory.produce () ; 
bus. run()? 
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// 生 产 自 行车 

BicycleFactory bicycleFactory = new BicycleFactory(); 
Vehicle bicycle = bicycleFactory.produce(); 
bicycle.run(); 


} 
/** 
* 抽象 工厂 类 
a 
interface Factory { 
/全 诺 
Vehicle produce (); 
} 
/** 
YE 
Eh 
class CarFactory implements Factory { 
@Override 
public Vehicle produce() { 


return new Car(); 


class BusFactory implements Factory { 
@Override 
public Vehicle produce() { 
return new Bus(); 


} 
/** 
二 自行 车 亚 局 
wh 
class BicycleFactory implements Factoryt 
@Override 
public Vehicle produce() { 
return new Bicycle(); 
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} 

/** 

* 交 通 工具 

wi 

interface Vehicle { 


Mehio bn abbey 


uth 

class Car implements Vehicle { 
QOverride 
udce voln ronml(y) 


Svskbemout peintln (veoar Fun .nn), 
} 
} 
/大 大 
* 公交 车 
wf 


class Bus implements Vehicle 1{ 
@Override 


public void run() { 


System.out.println("bus run..."); 
} 
} 
/** 
* 自行 车 
Wh 


class Bicycle implements Vehicle { 
@Override 
publieo vod un() A 
System.out .println("bicyecle rune. em"); 


} 


上 述 代码 中 ，Vehicle 类 是 抽象 产品 类 ， 而 Car、Bus、Bicycle 类 是 具体 产品 类 ， 并 且 实 现 
Vehicle 类 的 run 方法 。 每 一 种 具体 产品 类 都 有 一 一 对 应 的 工厂 类 CarFactory 、BusFactory、 
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BicycleFactory 等 ， 所 有 的 工厂 都 有 共同 的 抽象 父 类 Factory。 汽 车 与 工厂 具体 的 类 结构 如 图 3-5 


所 示 。 
Factory (工厂 类 》 


AAA 兴 父 


Vehicle 《交通 开具 》 | 


要 [ee [| [ny A]| [movaeractory (行车 I 厂 ) | [corractory (汽车 IT) 
上 | 5 一 


图 3-5 汽车 与 工厂 类 结构 图 


与 简单 工厂 模式 相 比 ， 工 三 方法 模式 最 重要 的 区 别 是 引入 了 抽象 工厂 角色 ， 抽 象 工厂 可 以 
是 接口 ， 也 可 以 是 抽象 类 或 者 具体 类 。 在 抽象 工厂 中 声明 了 工厂 方法 但 并 未 实现 工厂 方法 ， 具 
体 产 品 对 象 的 创建 由 其 子 类 负责 ， 客 户 端 针对 抽象 工厂 编程 ， 可 在 运行 时 再 指定 具体 工厂 类 ， 
具体 工厂 类 实现 了 工厂 方法 ， 不 同 的 具体 工厂 可 以 创建 不 同 的 具体 产品 。 


3.1.6 ”Spring Bean 工厂 类 详解 


Spring 的 bean 工厂 类 都 是 存放 在 spring-beans-5.0.3.RELEASE.jar 包 中 的 ， 可 以 使 用 Inteljjj 
IDEA 查看 Spring 的 类 结构 图 ， 有 具体 方法 是 : 【打开 DefaultListableBeanFactory 类 】 一 【右键 】 
一 【Diagrams】 一 【Show Diagram】 一 【Java Class Diagrams】〗】， 便 可 打开 如 图 3-6 所 示 的 Spring 
Bean 工厂 类 结构 图 。 


e BeanFactory: 定义 获取 bean 及 bean 的 各 种 属性 。 

e SimgletonBeanRegistry: 定义 对 单 例 的 注册 及 获取 。 

e DefaultSimgletonBeanRegistry: 对 接口 SimgletonBeanResistry 函 数 的 实现 。 

e FactoryBeanRegistrySupport : 在 DefaultSimgletonBeanRegistry 基础 上 增加 了 对 
BeanRegistry 的 特殊 处 理 功能 。 

e HierachicalBeanFactory: 继承 BeanFactory， 在 BeanFactory 定 义 的 功能 的 基础 上 增加 
了 对 parentFactory 的 支持 。 

e ListableBeanFactory: 根据 条 件 获取 bean 的 配置 清单 。 

e ConfigurableBeanFactory: 提供 配置 Factory 的 各 种 方法 。 

e AbstractBeanFactory: 综合 FactoryBeanRegistrySupport 和 ConfigurableBeanFactory 的 功能 。 
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¥ AlasRedistry 


不 
] 
9 Beanfactory 3 » SngletonteanRegistry > SimpleAliasRegistry » » BeanbetinitionRegisiry 
不 A 全 和 久 大 入 
i | T 
| | | 
| 
ListableDeanf actory * Hierarchicalbeanf actory © DefpaultSingletongeanReGiytry 
本 A A 
| | 
i 外 ContigurableBeanfactory FactorydeanReqgistry Support t 
| | 入 本 
i | 3 AutowireCopablebeont acory Es Abstructheanfaciory 
i | 大 A | 
Serializable 过 ConfigurablelistableBeanFactory 区 AbstyattAutowiret apableBeanFactory 
‘ 本 本 
is ps 2 


辐 Defaulltistabiedeanfactory 


图 3-6 Spring Bean 工厂 类 结构 图 
e AutowireCapableBeanFactory: 提供 创建 bean、 自 动 注入 、 初 始 化 以 及 应 用 bean 的 后 
处 理 器 。 
ConfigurableListableBeanFactory: BeanFactory 配 置 清单 ， 指 定 忽 略 类 型 及 接口 等 。 
e AbstractAutowireCapableBeanFactory: 综合 AbstractBeanFactory 并 对 接口 Autowire- 
CapableBeanFactory 进 行 实现 。 
DefaultListableBeanFactory: 整个 Bean 加 载 的 核心 部 分 ， 是 Spring 注册 和 加 载 Bean 的 
默认 实现 。 


Spring 源码 中 有 非常 多 的 地 方 用 到 了 工厂 模式 ， 几 乎 是 无 处 不 见 ， 但 是 笔者 决定 以 读者 最 
为 常用 的 Bean 来 讲解 ， 用 Spring 很 多 程度 上 是 依赖 它 的 对 象 管理 ， 也 就 是 IOC 容器 对 于 Bean 
的 管理 ，Spring 的 IOC 容器 如 何 创建 和 管理 Bean 其 实 是 比较 复杂 的 ， 它 并 不 在 我 们 本 书 的 讨论 
范围 中 ， 我 们 关心 的 是 Spring 如 何 利用 工厂 模式 来 实现 更 加 优良 的 松 耦 合 设计 。 

接 下 来 看 一 下 Spring 中 非常 重要 的 一 个 类 AbstractFactoryBean 是 如 何 利用 工厂 模式 的 。 


public abstract class AbstractFactoryBean<T> implements FactoryBean<T>, 
BeanClassLoaderAware, BeanFactoryAware, InitializingBean, DisposableBean { 
/** 
* Expose the singleton instance or create a new prototype instance. 
* Q@see #createInstance() 
* @see #getEarlySingletonIinterfaces () 
2 
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@Override 
public final T getObject() throws Exception { 
if (isSingleton()) 1 
zetuzn (this.initialized 2 
this.singletonInstance : getEarlySingletonInstance()); 
} 
else { 
return createlInstance(); 
} 
} 


protected abstract T createInstance () throws Exception; 
e AbstractFactoryBean: 实现 FactoryBean 类 ， 主 要 是 实现 getObject 方 法 ， 返 回 Bean 实 例 。 
e@e getObiject() : 如 果 是 单 例 且 已 经 创建 ， 返回 单 例 模式 ， 未 创建 调用 


getEarlySingletonInstance 方 法 ， 不 是 单 例 模式 ， 调 用 createInstance 方 法 。 
e createlnstance(): 由 子 类 负责 创建 具体 对 象 。 


3.2 Spring AOP 


3.2.1 Spring AOP 概述 


AOP 为 Aspect Oriented Programming 的 缩写 ， 意 为 面向 切面 编程 ， 通 过 预 编译 方式 和 运行 
期 动态 代理 实现 程序 功能 的 统一 维护 的 一 种 技术 。AOP 是 OOP 的 延续 ， 是 软件 开发 中 的 一 个 热 
点 ， 也 是 Spring 框架 中 的 一 个 重要 内 容 ， 是 函数 式 编程 的 一 种 衍生 范 型 。 利 用 AOP 可 以 对 业务 
逻辑 的 各 个 部 分 进行 隔离 ， 从 而 使 得 业务 逻辑 各 部 分 之 间 的 耦合 度 降 低 ， 提 高 程序 的 可 重用 性 和 
开发 效率 。 

AOP 主要 的 功能 有 日 志 记 录 、 性 能 统计 、 安 全 控制 、 事 务 处 理 和 异常 处 理 等 。 


3.2.2 ”Spring AOP 核心 概念 


首先 ， 来 简单 理解 一 下 什么 是 切面 ， 具 体 请 看 图 3-1 所 示 。 

Spring AOP 切面 简单 理解 就 像 一 把 刀 ， 在 代码 执行 过 程 中 ， 可 以 随意 地 插入 或 拔 出 。 在 插 
入 的 位 置 或 拔 出 的 位 置 可 以 “任意 妄 为 ”地 做 自己 喜欢 的 事情 ， 比 如 记录 上 日志、 控制 事务 、 安 
全 验证 服务 ， 等 等 。 
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| “添加 | | 
Li 名 | | nn | bs 
| | | | 
i 一 | 安全 验 [一 | 事务 [一 一 
服 化 修 改 证 服 2 桨 前 | 服务 | | 
| 切面 切面 | | 
| | | | | 
| ”者 询 | 商品 | 
| 站 要 
图 3-7 Spring AOP 切面 
Spring AOP 核心 概念 如 表 3-1 所 示 。 
表 3-1 Spring AOP 核心 概念 
下 说 明 
横 切 关注 点 对 哪些 方法 进行 拦截 ， 拦 截 后 怎么 处 理 ， 这 些 关注 点 称 之 为 横 切 关注 点 
切面 (aspect) 类 是 对 物体 特征 的 抽象 ， 切 面 就 是 对 横 切 关注 点 的 抽象 


连接 点 (joinpoint) | 被 拦截 到 的 点 ， 因 为 Spring 只 支持 方法 类 型 的 连接 点 ， 所 以 在 Spring 中 连接 点 
~ 指 的 就 是 被 拦截 到 的 方法 ， 实 际 上 连接 点 还 可 以 是 字段 或 构造 器 
切入 点 pointcut) ”| 对 连接 点 进行 拦截 的 定义 


0 ey 所 谓 通 知 指 的 就 是 指 拦截 到 连接 点 之 后 要 执行 的 代码 ， 通 知 分 为 前 置 、 后 置 、 异 
常 、 最 终 、 环 绕 通知 5 类 

目标 对 象 代理 的 目标 对 象 

织 入 (weave) 将 切面 应 用 到 目标 对 象 并 导致 代理 对 象 创建 的 过 程 


引入 (introduction〉 | 在 不 修改 代码 的 前 提 下 ， 引 入 可 以 在 运行 期 为 类 动态 地 添加 一 些 方法 或 字段 
Spring AOP 通知 (advice) 分 成 5 类， 具体 如 表 3-2 所 示 。 


表 3-2 Advice 通知 类 型 


名 称 


前 置 通知 (Before advice) 


说 了 明 
在 连接 点 前 面 执行 ， 前 置 通知 不 会 影响 连接 点 的 执行 ， 除 非 此 
处 抛 出 异常 

在 连接 点 正常 执行 完成 后 执行 ， 如 果 连 接点 抛 出 异常 ， 则 不 会 
执行 


正 返回 通知 (After returning advice) 


仅 供 非 商业 用 途 或 交流 学 习 使 用 
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名 称 说 明 

异常 返回 通知 (After throwing advice) | 在 连接 点 抛 出 异常 后 执行 

在 连接 点 执行 完成 后 执行 ， 不 管 是 正常 执行 完成 ， 还 是 抛 出 异 
常 ， 都 会 执行 返回 通知 中 的 内 容 

环绕 通知 围绕 在 连接 点 前 后 ， 比 如 一 个 方法 调用 的 前 后 。 这 是 
最 强大 的 通知 类 型 ， 能 在 方法 调用 前 后 自 定义 一 些 操作 。 环 绕 
通知 还 需要 负责 决定 是 继续 处 理 join point (调用 
ProceedingJoinPoint 的 proceed 方法 ) 还 是 中 断 执 行 


后 通知 (After (finally) advice) 


环绕 通知 (Around advice) 


3.2.3”JDK 动态 代理 实现 日 志 框架 


Spring AOP 内 部 是 使 用 动态 代理 模式 来 实现 的 ， 这 一 节 通 过 动态 代理 模式 来 实现 最 简单 的 
日 志 框 架 ， 帮 助 读者 快速 理解 Spring AOP 的 内 部 实现 原理 。 

首先 ， 在 springmvc-mybatis-book 项 目 包 com.ay.test 下 创建 业务 接口 类 BusinessClassService， 
具体 代码 如 下 : 


package com.ay.test; 
/** 

* 描述 : 业务 类 接口 

* Gauthor Ay 

* @create 2018/04/22 
**/ 


public interface BusinessClassService { 


void doSsomeThing(); 
} 


BusinessClassService 业务 接口 类 可 以 理解 为 日 常 开发 业务 创建 的 接口 类 ， 接 口中 有 一 个 简 
单 的 方法 doSomeThing。 然 后 ， 开 发 业务 类 的 实现 类 BusinessClassServiceImpl， 具 体 代 码 如 下 : 


package com.ay.test; 


/** 

* 描述 : 业务 实现 类 

* Qauthor Ay 

* @create 2018/04/22 
**/ 


public class BusinessClassServiceImpl implements BusinessClassServicel{ 


/** 
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* 处 理 业务 

gh 

public void doSomeThing(){ 
System.out.printin("do something ...... 了 


} 


j 途 或 交流 学 习 使 用 


实现 类 BusinessClassServiceImpl 实现 了 BusinessClassService 接口 ， 并 实现 了 doSomeThing 


方法 ， 在 方法 中 打印 “do something .….”。 
接着 ， 开 发 日 志 接 口 类 MyLogger， 有 具体 代码 如 下 : 


package com.ay.test,; 
import java.lang.reflect.Method; 
/** 
* 描述 : 日 志 类 接口 
* @author Ay 
* @create 2018/04/22 
大 大 / 
public interface MyLogger { 
/x** 
* 纪录 进入 方法 时 间 
2 
void saveIntoMethodTime (Method method); 
/大 大 
* 纪录 退出 方法 时 间 
yk 
void saveOutMethodTime (Method method); 
} 


e SavelntoMethodTime: 记录 进入 方法 的 时 间 。 
ee SaveOutMethodTime: 记录 退出 方法 的 时 间 。 


接口 类 MyLogger 开发 完成 之 后 ， 用 MyLoggerImpl 类 实现 它 ， 有 具体 代码 如 下 : 


package com.ay.test,; 
import java.lang.reflect.Method; 


/** 

* 描述 : 日 志 实 现 类 

* Qauthor RAY 

* @create 2018/04/22 
X*/ 
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public class MyLoggerIimpl] implements MyLogger { 


public void saveIntoMethodTime (Method method) { 
System.out .println(" 进 入 " + method.getName() + 
"方法 时 间 为 : " + System.currentTimeMillis ())， 


public void saveOutMethodTime (Method method) { 
System.out .println(" 退 出 ”+ method.getName () + "方法 时 间 为 : " + 
System.currentTimeMil1lis()); 


} 


MyLoggerImpl 类 实现 接口 MyLogger， 并 实现 saveIntoMethodTime 和 saveOutMethodTime 
方法 ， 在 方法 内 部 打印 进入 /退出 方法 的 时 间 。 
最 后 ， 实 现 最 重要 的 类 MyLoggerHandler， 具 体 代码 如 下 : 


package com.ay.test; 
import javax.annotation.Resource; 
import java.lang.reflect.InvocationHandler; 


import java.lang.reflect.Method; 


/** 

* 描述 : 日 志 类 Handler 
* @author Ay 

* @create 2018/04/22 
大 大 / 


public class MyLoggerHandler implements InvocationHandler { 


// 原 始 对 象 
private Object objOriginal; 
// 这 里 很 关键 


private MyLogger myLogger = new MyLoggerIimpl (); 
public MyLoggerHandler (Object obj)f{ 


super () ; 
this.objOriginal = obj; 


public Object invoke (Object proxy, Method method, Object[] args) throws 
Throwable { 
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Object result = null; 

// 日 志 类 的 方法 : 保存 进入 方法 的 时 间 
myLogger.savelintoMethodTime (method); 

// 调 用 代理 类 方法 

result = method.invoke (this.objOriginal ,args); 
// 日 志 类 方法 : 保存 退出 方法 的 时 间 


myLogger.saveOutMethodTime (method); 


return result; 


} 


e InvocationHandler: 该 接口 中 仅 定义 了 一 个 方法 : public Object invoke(Object obj, 
Method method，Object[] args)， 在 使 用 时 ， 第 一 个 参数 obj 一 般 是 指 代理 类 ，method 是 


被 代理 的 方法 ，args 为 该 方法 的 参数 数组 。 这 个 抽象 方法 在 代理 类 中 动态 实现 。 
所 有 的 代码 开发 完成 之 后 ， 开 发 测试 类 MyLoggerTest 进行 测试 ， 具 体 代码 如 下 : 


package com.ay.test; 
import java.lang.reflect.Proxy; 
/** 
* 描述 : 测试 类 
* @author Ay 
erneates20l8/04/22 
**/ 
public class MyLoggerTest { 


PubLlie static void main(Stringll] args) 
// 实 例 化 真实 项 目 中 业务 类 
BusinessClassService businessClassService = 
new BusinessClassServiceImpl (); 
// 日 志 类 的 handler 
MyLoggerHandler myLoggerHandler = 


new MyLoggerHandler (businessClassService); 


// 获 得 代理 类 对 象 
BusinessClassService businessClass = (BusinessClassService) 
Proxy.newProxyInstance (businessClassService.getClass(). 


getClassLoader(),businessClassService.getClass() .getinterfaces(), 


myLoggerHandler); 
// 执 行 代理 类 方法 


businessClass.dqoSomeThing() ; 


仅 供 非 商 业 用 途 或 交流 学 习 使 
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e Proxy.newProxylnstance : 


该 类 即 为 动态 代理 类 ， 


static Object newProxyInstance 


(ClassLoader loader, Class[] interfaces, InvocationHandler h)， 返 回 代 理 类 的 一 个 实例 ， 返 
回 后 的 代理 类 可 以 当 作 被 代理 类 使 用 。 在 Proxy.newProxyInstance 方 法 中 ， 共 有 以 下 三 


个 参数 : 


ba 


ClassLoader loader: targetObject.getClass().getClassLoader() 目 标 对 象 通过 getClass 


方法 获取 类 的 所 有 信息 后 ， 调 用 getClassLoader() 方 法 来 获取 类 加 载 器 。 获 取 类 加 载 
器 后 ， 可 以 通过 这 个 类 型 的 加 载 器 ， 在 程序 运行 时 ， 将 生成 的 代理 类 加 载 到 JVM 即 


Java 庶 拟 机 中 ， 以 便 运 行 时 需要 。 


Class[] interfaces: targetObject.getClass().getInterfaces() 获 取 被 代理 类 的 所 有 接口 信 


息 ， 以 便于 生成 的 代理 类 可 以 具有 代理 类 接口 中 的 所 有 方法 。 


InvocationHandler h: 使 用 动态 代理 是 为 了 更 好 地 扩展 ， 比 如 在 方法 之 前 做 什么 操 


作 ， 之 后 做 什么 操作 ， 这 个 时 候 这 些 公 共 的 操作 可 以 统一 交 给 代理 类 去 做 。 此 时 需 
要 调用 实现 了 InvocationHandler 类 的 一 个 回调 方法 。 


运行 测试 类 的 main 方法 ， 便 可 以 在 Intellij IDEA 控制 台 查 看 打印 信息 ， 有 具体 信息 如 下 : 


进入 doSomeThing 方法 时 间 为 : 1524385006965 
do something 
退出 doSomeThing 方法 时 间 为 : 1524385006966 


以 上 就 是 利用 动态 代理 模式 实现 简单 的 日 志 框架 ， 其 体 


MyLogger | InvocationHandi 
eg [ 
] [ 
| | MyLoggerHandler 


#yLogger Imp| 


lnvoke 


的 结构 如 图 3-8 所 示 。 


MyLogger 


MyLogger imp| 


savelntollethodTime 4 saveDutMethodT ime 
论 江 进入 方法 的 时 阅 记录 进出 方法 的 时 间 
LL 一 


BusinessClassService 


图 3-8 Spring AOP 实现 日 志 届 
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这 里 总 结 一 下 JDK 动态 代理 的 一 般 实 现 步 又: 


(1) 创建 一 个 实现 InvocationHandler 接口 的 类 MyLoggerHandler， 它 必须 实现 invoke 方法 。 
(2) 创建 被 代理 的 类 BusinessClassService 以 及 接口 BusinessClassServiceImpl。 

(3) 调用 Proxy 的 静态 方法 newProxyInstance， 创 建 一 个 代理 类 。 

(4) 通过 代理 类 调用 方法 。 


3.2.4 Spring AOP 实现 日 志 框架 


使 用 Spring AOP 的 注解 方式 实现 日 志 框 架 是 非常 简单 的 。 首 先 ， 在 配置 文件 
spring-mvc.xml 中 添加 配置 ， 具 体 代码 如 下 : 


<aop:aspectj-autoproxy proxy-target-class="true"> 


e@ </aop:aspectj-autoproxy>: 声明 自动 为 Spring 容 器 中 那些 配置 @aspectJ 切 面 的 bean 创 建 
代理 ， 织 入 切面 。<aop:aspectj-autoproxy /> 有 一 个 proxy-target-class 属 性 ， 默 认为 false， 
表示 使 用 JDK 动 态 代理 织 入 增强 ， 当 配置 poxy-target-class 为 true 时 ， 表 示 使 用 CGLib 动 
态 代 理 技术 织 入 增强 。 不 过 即使 设置 proxy-target-class 为 false， 如 果 目 标 类 没有 声明 接 
口 ， 则 Spring 将 自动 使 用 CGLib 动 态 代 理 。 


配置 添加 完成 之 后 ， 要 定义 一 个 切面 LogInterceptor， 具 体 代 码 如 下 : 


package com.ay.proxy; 

import org.aspectj.lang.annotation.After; 
import org.aspectj.lang.annotation.Aspect; 
import org.aspectj.lang.annotation.Before; 


import org.springframework.stereotype.Component; 


/火炎 

* 描述 : 日 志 拦 截 类 (切面 ) 

* Q@author Ay 

* @create 2018/04/22 

**/ 

@Aspect 

@Component 

public class LogInterceptor { 


@Before(value = "execution(* com.ay.controller.*.*(..))") 
public void before() { 
System.out.println ("进入 方法 时 间 为 :" + System.currentTimeMillis()); 
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After (value = "execution(* com.ay.controller.*.*(..))") 
public void aftez (){ 

System.out .println(" 退 出 方法 时 间 为 :" + System.currentTimeMillis()); 
} 


@Aspect: 标识 LogInterceptor 类 为 一 个 切面 ， 供 容器 读 取 。 

@Before: 在 所 拦截 方法 执行 之 前 执行 before 方 法 。 

@After: 在 所 拦截 方法 执行 之 后 执行 after 方 法 。 

e @Around: 可 以 同时 在 所 拦截 方法 的 前 后 执行 一 段 远 辑 。 

e execution 切 入 点 指示 符 : com.ay.controller.*.*(..) 表 示 在 controller 包 中 定义 的 任意 方法 
的 执行 。execution 切 入 点 指示 符 执 行 表达 式 的 格式 如 下 : 


execution (modifiers-pattern? ret-type-pattern declaring-type-pattern? 


name-pattern (param-pattern) throws-pattern?) 

execution (方法 修饰 符 ” 方 法 返回 值 方法 所 属 类 匹配 方法 名 (方法 中 的 形 参 表 ) 方法 申明 抛 
出 的 异常 ) 

其 中 黑色 字体 部 分 不 能 省 略 ， 各 部 分 都 支持 通配符 “*” 来 匹配 全 部 。 比 较 特 殊 的 为 形 参 
表 部 分 ， 其 支持 以 下 两 种 通配符 : 

"xn : 代表 一 个 任意 类 型 的 参数 。 

". .": 代表 零 个 或 多 个 任意 类 型 的 参 。 

例如 : 


() : 匹配 一 个 无 参 方法 

(..) : 匹配 一 个 可 接受 任意 数量 参数 和 类 型 的 方法 

(*) : 匹配 一 个 接受 一 个 任意 类 型 参数 的 方法 

(*，Integer) : 匹配 一 个 接受 两 个 参数 的 方法 ， 第 一 个 可 以 为 任意 类 型 ， 第 二 个 必须 为 Integer。 


下 面 举 一 些 execution 的 使 用 实例 ， 有 具体 内 容 见 表 3-3。 
表 3-3 切入 点 表达 式 实例 


切入 点 表达 式 说 明 

二 类 隐 ic 方法 ， 第 一 个 * 汶 ; I， 第 一 个 
eitiontoiblic + ee 标 类 的 public 方法 ， 第 一 个 * 为 返回 类 型 ， 第 二 -11 
execution(* save* (..)) 匹配 所 有 目标 类 以 save 开头 的 方法 ， 第 一 个 * 代 表 返 回 类 型 
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切入 点 表达 式 说 ” 明 

匹配 目标 类 所 有 以 product 结尾 的 方法 ， 并 且 其 方法 的 参数 表 
第 一 个 参数 可 为 任意 类 型 ， 第 二 个 参数 必须 为 String 
execution(* aop_part.Demol.service.*(..)) | 匹配 service 接口 及 其 实现 子 类 中 的 所 有 方法 

execution(* aop_part.*(..)) 匹配 aop_part 包 下 的 所 有 类 的 所 有 方法 ， 但 不 包括 子 包 

匹配 aop_part 包 下 的 所 有 类 的 所 有 方法 ， 包 括 子 包 。( 当 ".…" 出 
现在 类 名 中 时 ， 后 面 必须 跟 “*”, 表 示 包 、 子 孙 包 下 的 所 有 类 ) 
匹配 aop_part 包 及 其 子 包 下 的 所 有 后 缀 名 为 service 的 类 中 ， 
所 有 方法 名 必须 以 find 为 前 级 的 方法 

匹配 所 有 方法 名 为 fo0， 且 有 两 个 参数 ， 其 中 ， 第 一 个 的 类 型 
为 String， 第 二 个 的 类 型 为 int 

匹配 所 有 方法 名 为 fo0o， 且 至 少 含 有 一 个 参数 ， 并 且 第 一 个 参 
数 为 String 的 方法 (后 面 可 以 有 任意 个 类 型 不 限 的 形 参 ) 


execution(**product(*,String)) 


execution(* aop_part..*(..)) 


execution(* aop_part..*.*service,find*(..)) 


execution(*foo(String,int)) 


execution(* foo(String,..)) 


切面 类 LogInterceptor 开发 完成 之 后 ， 重 新 启动 springmvc-mybatis-book 项 目 ， 项 目 成 功 启 
动 后 ， 在 浏览 器 输入 网 址 : http://localhost:8080/user/findAll， 便 可 以 在 Intellij IDEA 开发 工具 的 
控制 台 看 到 如 下 的 打印 信息 : 

进入 方法 时 间 为 :1524411433320 

els i 

name: 阿 谢 

le 

name: 阿兰 


退出 方法 时 间 为 :1524411434036 


3.2.5 ”静态 代理 与 动态 代理 模式 


Spring AOP 使 用 的 是 动态 代理 模式 ， 所 以 有 必要 简单 学 习 一 下 动态 代理 模式 。 

代理 模式 定义 如 下 : 

代理 模式 给 菜 一 个 对 象 提供 一 个 代理 或 占 位 符 ， 并 由 代理 对 象 来 控制 对 原 对 象 的 访问 。 

代理 模式 是 一 种 对 象 结构 型 模式 。 在 代理 模式 中 引入 了 一 个 新 的 代理 对 象 ， 代 理 对 象 在 客 
户 端 对 象 和 目标 对 象 之 间 起 到 中 介 的 作用 ， 它 去 掉 客户 不 能 看 到 的 内 容 和 服务 或 者 增添 客户 需 
要 的 额外 的 新 服务 。 

代理 模式 的 结构 比较 简单 ， 其 核心 是 代理 类 ， 为 了 让 客户 端 能 够 一 致 性 地 对 待 真实 对 象 和 
代理 对 象 ， 在 代理 模式 中 引入 了 抽象 屋 ， 代 理 模 式 结构 如 图 3-9 所 示 。 
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Subject 


+operation() 


RealSubject 


+RealSubject realSubject 
+preOperation() 
+0peration() 
+postOperation() 


+operation() 


图 3-9 代理 模式 类 结构 图 


由 图 3-9 可 知 ， 代 理 模 式 包含 如 下 三 个 角色 : 


Subject (抽象 主题 角色 ) : 它 声 明了 真实 主题 和 代理 主题 的 共同 接口 ， 这 样 一 来 在 任 
何 使 用 真实 主题 的 地 方 都 可 以 使 用 代理 主题 ， 客 户 端 通常 需要 针对 抽象 主题 角色 进行 
编程 。 

Proxy〔 代 理 主题 角色 ) : 它 包 含 了 对 真实 主题 的 引用 ， 从 而 可 以 在 任何 时 候 操作 真实 
主题 对 象 ; 在 代理 主题 角色 中 提供 一 个 与 真实 主题 角色 相同 的 接口 ， 以 便 在 任何 时 候 
都 可 以 替代 真实 主题 ; 代理 主题 角色 还 可 以 控制 对 真实 主题 的 使 用 ， 负 责 在 需要 的 时 
候 创建 和 删除 真实 主题 对 象 ， 并 对 真实 主题 对 象 的 使 用 加 以 约束 。 通 常 ， 在 代理 主题 
角色 中 ， 客 户 端 在 调用 所 引用 的 真实 主题 操作 之 前 或 之 后 还 需要 执行 其 他 操作 ， 而 不 
仅仅 是 单纯 调用 真实 主题 对 象 中 的 操作 。 

RealSubject (真实 主题 角色 ) : 它 定义 了 代理 角色 所 代表 的 真实 对 象 ， 在 真实 主题 角 
色 中 实现 了 真实 的 业务 操作 ， 客 户 端 可 以 通过 代理 主题 角色 间接 调用 真实 主题 角色 中 
定义 的 操作 。 


静态 代理 模式 具体 的 代码 如 下 : 


package com.ay.test; 
/** 


* 描述 : 客户 端 类 

* @author Ay 

* Qcreate 2018/04/22 
**/ 


public class ProxyPatternt{ 


public static void main(String[] args) { 


72 | Spring MVC + MyBatis 快速 开发 与 项 目 实战 


// 为 每 个 RealSubject 创建 代理 类 Proxy 
Proxy proxy = new Proxy (new RealSubject () ) ; 
Proxy.operation(); 


} 
/** 
* 描述 : 抽象 主题 类 
x @author Ay 
* @create 2018/04/22 
WS 
abstract class Subject { 
abstract void operation (); 
} 


/** 

* 描述 ， 具 体 主题 类 

* Qauthor Ay 

* @create 2018/04/22 

wp 

class RealSubject extends Subjectt{ 


void operation() { 
System.out.println ("operation Se a 


} 

/** 

* 描述 ， 代 理 类 

* Qauthor Ay 

* Qcreate 2018/04/22 

**/ 

Class Proxy extends Subject{ 


private Subject subject; 
public Proxy (Subject Subject) { 
this.subject = subject; 


} 


Void operation() { 


// 前 置 处 理 
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this.Ppzeoperation()， 
// 具 体操 作 

subject .operation(); 
// 后 置 处 理 
this.postOperation(); 


} 


void preOperation(){ 
System.out.println("pre operation...... > 


} 


void postOperation(){ 
System.out.println("post operation...... 有 
} 
} 


上 面 介绍 的 代理 模式 也 被 称 为 “静态 代理 模式 ”， 这 是 因为 在 编译 阶段 就 要 为 每 个 
RealSubject 类 创建 一 个 Proxy 类 ， 当 需要 代理 的 类 很 多 时 ， 就 会 出 现 大 量 的 Proxy 类 ,所 以 可 以 
使 用 JDK 动态 代理 解决 这 个 问题 。 关 于 JDK 动态 代理 实例 ， 读 者 可 以 参考 3.2.3 节 ，JDK 动态 
代理 的 实现 原理 是 动态 创建 代理 类 并 通过 指定 类 加 载 器 加 载 ， 然 后 在 创建 代理 对 象 时 将 
InvokerHandler 对 象 作为 构造 参数 传 入 。 当 调用 代理 对 象 时 ， 会 调用 InvokerHandler.invoke() 方 
法 ， 并 最 终 调 用 真正 业务 对 象 的 相应 方法 。 


MyBatis 映射 器 与 动态 SQL 


本 章 主要 介绍 MyBatis 常用 的 映射 器 元 素 、 动 态 SQL 元 素 、MyBatis 注解 配置 和 关联 映射 。 


4.1 MyBatis 映射 器 


一 


4.1.1 映射 器 的 主要 元 素 
Mybatis 提供 了 强大 的 映射 器 ， 并 且 提供 了 丰富 的 映射 器 元 素 ， 具 体 如 表 4-1 所 示 。 


表 4-1 映射 器 元 素 
元 素 名 称 描述 
select 映射 查询 语句 
insert 映射 插入 语句 
update 映射 更 新 语句 
delete 映射 删除 语 名 
sql 可 以 被 其 他 语句 引用 的 可 重用 语句 块 
resultMap 用 来 描述 如 何 从 数据 库 结果 集中 来 加 载 对 象 
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元 素 名称 描 述 
cache 给 定 命 名 空间 的 缓存 配置 


cache-ref 其 他 命名 空间 缓存 配置 的 引用 


接 下 来 详细 讨论 映射 器 中 主要 元 素 的 用 法 。 


4.1.2” select 元 素 


select 元 素 是 Mybatis 中 最 常用 的 元 素 之 一 ，select 元 素 可 以 从 数据 库 读 取 数 据 ， 组 装 数据 
给 业务 人 员 。 比 如 可 以 在 配置 文件 AyUserMapper.xml 中 使 用 select 元 素 ， 根 据 用 户 Id 查询 
ay_user 表 〈2.2.4 节 已 创建 ) 中 的 具体 用 户 ， 有 具体 代码 如 下 : 


<select id="findByld" parameterType="String" 
resultType="com.ay.model .AyUser"> 
SEEBCGT * FROM ay USer 
WHERE id = #{id} 
</select> 


这 个 语句 被 称 为 findById， 接 受 一 个 String 类 型 的 参数 ， 并 返回 一 个 User 类 型 的 对 象 。 参 
数 #{id} 是 告诉 MyBatis 创建 一 个 预 处 理 语句 参数 。 通 过 JDBC， 这 样 的 一 个 参数 在 SQL 中 会 由 
一 个 “? ”来 标识 ， 并 被 传递 到 一 个 新 的 预 处 理 语 句 中 。 上 面 的 SQL 语句 执行 时 会 生成 如 下 
JDBC 代码 : 


String findBvyld = "SbEBCL ”FROM ay Use WHERE 9 
PreparedStatement ps = conn.prepareStatement (findById); 
psuvSsetSstring(L, 2Q) 7 


接口 AyUserDao 中 定义 的 方法 如 下 : 


AyUser findBylId(String id); 
select 元 素 提 供 了 很 多 配置 属性 ， 具 体 如 表 4-2 所 示 。 


表 4-2 ”select 元 素 配 置 
属性 名 称 摘 |“ 述 
它 和 mapper 的 命名 空间 组 合 起 来 是 唯一 的 ，id 的 值 和 DAO 接口 的 方法 名 一 致 。 如 
果 不 唯一 或 者 不 一 致 ，MyBatis 将 抛 出 异常 
将 会 传 入 语句 参数 类 的 全 名 码 或 者 别名 ， 这 个 属性 是 可 选 的 ， 因 为 MyBatis 可 以 通 
parameterType 过 TypeHandler 推断 出 具体 传 入 语句 的 参数 ， 默 认 值 为 unset。 可 以 选择 JavaBean、 
Map 等 复杂 的 参数 类 型 传递 给 SQL 


id 
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( 续 表 ) 

属性 名 称 描 述 

parameterMap 即将 废弃 的 元 素 ， 不 再 讨论 
从 语句 中 返回 期 望 类 型 的 类 的 完全 限定 名 或 别名 。 注 意 如 果 是 集合 的 情形 ， 那 应 该 

ilies 是 集合 可 以 包含 的 类 型 ， 而 不 能 是 集合 本 身 。 返 回 时 可 以 使 用 resultType 或 者 
resultMap, 但 不 能 同时 使 用 。 结 果 集 将 通过 JavaBean 的 规范 映射 或 定义 为 int、double、 
float 等 参数 

siliap 它 是 映射 集 的 引用 ， 将 执行 强大 的 映射 功能 ， 可 以 使 用 resultType 或 者 resultMap 其 
中 的 一 个 ，resultMap 可 以 给 予 我 们 自 定义 映射 规则 的 机 会 

pe 它 的 作用 是 调用 SQL 后 ， 是 否 要 求 MyBatis 清空 之 前 查询 的 本 地 缓存 和 二 级 缓存 ， 
取 值 为 false/true， 默 认为 false 

useCache 启动 二 级 缓存 的 开关 ， 取 值 true/false， 默 认 值 为 true 

timeout 设置 超时 参数 ， 等 超时 的 时 候 抛 出 异常 ， 单 位 为 秒 

fetchSize 获取 记录 的 总 条 数 设 定 

as 告诉 MyBatis 使 用 哪个 JDBC 的 Statement 工作 , 取 值 为 STATEMENT、 PREPARED 
或 者 CALLABLE。 默 认为 PREPARED 
它 的 值 包括 FORWARD_ONLY (游标 允许 向 前 访问 ) |SCROLL SENSITIVE (双向 滚 

mae 动 ， 并 及 时 跟踪 数据 库 更 新 ， 以 便 更 改 resultSet 中 的 数据 ) |SCROLL INSENSITIVE 
〈 双 向 滚动 ， 但 不 及 时 跟踪 数据 库 更 新 ， 数 据 库 里 的 数据 修改 ， 并 不 在 resultSet 中 
反应 过 来 ) 

pM 如 果 设置 了 databaseIdProvider，MyBatis 会 加 载 所 有 的 不 带 databaseld 或 匹配 当前 
databaseld 的 语句 ， 如 果 带 或 者 不 带 的 语句 都 有 ， 则 不 带 的 会 被 忽略 
这 个 设置 仅 针对 嵌 套 结果 select 语句 : 如 果 设 置 为 tue， 就 说 假设 包含 了 藤 套 结果 集 

resultOrdered 或 者 分 组 了 ， 这 样 的 话 ， 当 返回 一 个 主 结果 行 的 时 候 ， 就 不 会 发 生 对 前 面 结果 集 引 
用 的 情况 。 这 就 使 得 获取 嵌 套 的 结果 集 时 不 至 于 导致 内 存 不 够 用 。 默 认为 false 

ov 适应 于 多 个 结果 集 的 情况 ， 它 将 列 出 执行 SQL 后 每 个 结果 集 的 名 称 ， 每 个 名 称 之 间 


用 逗号 分 隔 。 使 用 比较 少 


下 面 再 来 看 几 个 select 元 素 的 例子 : 
// 实 例 1: 通过 名 称 查询 用 户 


<select id="findByName" parameterType="String" resultType= 


"com.ay.model.AyUser"> 


SELECT * FROM ay use 
WHERE name = #{name} 


</select> 


// 实 例 2: 通过 名 称 查 询 用 户 个 数 
<select id="countByName" parameterType="String" resultType="int"> 
SELECT Count (*) FROM ay user 


第 4 章 ”MyBatis 映射 器 与 动态 SQL | 77 


WHERE name = #{name} 
</select> 


对 应 的 AyUserDao 接口 如 下 : 


List<AyUser> findByName (String name); 
int countByName (String name); 


4.1.3 insert 元 素 


insert 元 素 用 来 映射 DML 语句 ，MyBatis 会 在 执行 插入 之 后 返回 一 个 整数 ， 来 表示 进行 操 
作 后 插入 的 记录 数 ，insert 元 素 的 属性 和 select 元 素 属性 差不多 ， 特 有 的 属性 如 表 4-3 所 示 。 


表 4-3 insert 元 素 配 置 
属性 名 称 描 述 
令 MyBatis 使 用 JDBC 的 useGeneratedKeys 方法 来 获取 由 数据 库 内 部 生成 的 主键 ， 
useGeneratedKeys | 例如 MySQL 和 SQL Server 自动 递增 字段 ，Oracle 的 序列 等 ， 使 用 它 时 必须 给 
keyProperty 或 者 keyColumn 赋值 


keyProperty 表示 以 哪个 列 作为 属性 的 主键 ， 不 能 和 keyColumn 同时 使 用 
keyColumn 指明 第 几 列 是 主键 ， 不 能 和 keyProperty 同时 使 用 ， 只 接受 整形 参数 
下 面 来 看 几 个 例子 : 


/7 实例 1: 插入 用 户 数据 
<insert id="insert" parameterType="com.ay.model.AyUser"> 
INSERT INTO ay user (id, name, password) VALUE (#{id}, #{name}, #{password}); 
</insert> 
// 实 例 2: 插入 用 户 数据 ， 主 键 自 增 
<insert id="insert" useGeneratedKeys="true" 
keyProperty="id" parameterType="com.ay.model.AyUser"> 
INSERT INTO ay user(name, password) VALUE (#{name}, #{password}); 
</insert> 


对 应 的 AyUserDao 接口 如 下 : 
int insert (AyUser ayUser); 
4.1.4 ”selectKey 元 素 


可 以 使 用 keyProperty 属性 指定 哪个 是 主键 字段 ， 同 时 使 用 useGeneratedKeys 属性 告诉 
MyBatis 这 个 主键 是 否 使 用 数据 库 内 置 策略 生成 。 实 际 工作 中 往往 并 非 想象 中 的 那么 简单 ， 比 
如 希望 通过 原 有 主键 Id + 1 的 方式 生成 主键 4， 具体 代 码 如 下 : 
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<insert id="insert" useGeneratedKeys="true" 
keyProperty="id" parameterType="com.ay.model.AyUser"> 
<selectKey keyProperty="id" resultType="int" order="BEFORE"> 
SELECT MAX(id) + 1 AS id FROM ay user 
</selectKey> 
INSERT INTO ay user(id, name, password) VALUE (#{id}, #{name}, 
#{password}); 
</insert> 


selectKey 元 素描 述 如 下 : 
<selectKey 
keyProperty="id" 
resultType="int" 
order="BEFORE" 
statementType="PREPARED"> 


selectKey 元 素 属性 配置 具体 如 表 4-4 所 示 。 
表 4-4 selectKey 元 素 配 置 


属性 名 称 描 述 
selectKey 语句 结果 应 该 被 设置 的 目标 属性 ， 一 般 会 设置 到 id 属性 ， 如 果 希 望 得 到 多 个 


keyProperty | 生成 的 列 ， 可 以 用 逗号 分 隔 属性 名 称 列表 
CU | 严 本 属性 的 返回 结果 集中 的 列 名 称 。 如果 希 望 得 到 多 个 生成 的 列 ,可 以 用 运 号 分 属性 


名 称 列表 

resultType 结果 的 类 型 

可 以 设置 为 BEFORE 或 者 AFTER。 设 置 为 BEFORE， 那 么 它 会 首先 选择 主键 ,设置 
order keyProperty， 然 后 执行 插入 语句 。 如 果 设 置 为 AFTER， 那 么 先 执行 插入 语句 ， 然 后 是 
selectKey 元 素 

statementType | 与 select 元 素 属性 相同 ， 具 体 看 4.1.2 节 的 内 容 


4.1.5 ”update 元 素 


update 元 素 用 来 映射 DML 语句 ， 主 要 用 来 更 新 数据 库 中 的 数据 ，MyBatis 会 在 执行 更 新 操 
作 之 后 返回 一 个 整数 ， 来 表示 进行 操作 后 更 新 的 记录 数 ，update 元 素 属性 和 select 元 素 属 性 差 不 
多 ， 它 们 特有 的 属性 如 表 4-5 所 示 。 


非 卖 品 ， 仅 供 非 商 业 用 途 或 交流 学 习 使 用 
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表 4-5 update 元素 配置 


属性 名 称 描 述 
令 MyBatis 使 用 JDBC 的 useGeneratedKeys 方法 来 获取 由 数据 库 内 部 生成 的 主键 ， 
useGeneratedKeys | 例如 MySQL 和 SQL Server 自动 递增 字段 ，Oracle 的 序列 等 ， 使 用 它 时 必须 给 
keyProperty 或 者 keyColumn 赋值 
keyProperty 表示 以 哪个 列 作为 属性 的 主键 ， 不 能 和 keyColumn 同时 使 用 
keyColumn 指明 第 几 列 是 主键 ， 不 能 和 keyProperty 同时 使 用 ， 只 接受 整形 参数 


下 面 来 看 一 个 具体 的 实例 : 


<update id="update" parameterType="com.ay.model.AyUser"> 
UPDALE ov user SE 


name = 


#{name}, 


password = #{password} 
WHERE id = #{id} 


</update> 


对 应 的 AyUserDao 接口 如 下 : 


int update (AyUser ayUser); 


4.1.6 delete 元 素 


delete 元 素 用 来 映射 DML 语句 ， 主 要 用 来 删除 数据 库 中 的 数据 ，MyBatis 会 在 执行 删除 操 
作 之 后 返回 一 个 整数 ， 来 表示 进行 删除 后 更 新 的 记录 数 ，delete 元 素 属性 和 select 元 素 属 性 差 不 
多 ， 它 们 特有 的 属性 如 表 4-6 所 示 。 


表 4-6 ”delete 元 素 配 置 


属性 名 称 描 述 
令 MyBatis 使 用 JDBC 的 useGeneratedKeys 方法 来 获取 由 数据 库 内 部 生成 的 主键 ， 
useGeneratedKeys | 例如 MySQL 和 SQL Server 自动 递增 字段 ，Oracle 的 序列 等 ， 使 用 它 时 必须 给 
keyProperty 或 者 keyColumn 赋值 
keyProperty 表示 以 哪个 列 作为 属性 的 主键 ， 不 能 和 keyColumn 同时 使 用 
keyColumn 指明 第 几 列 是 主键 ， 不 能 和 keyProperty 同时 使 用 ， 只 接受 整形 参数 
下 面 来 看 几 个 具体 的 实例 : 


/7 实例 1: 根据 id 删除 记录 
<delete id="delete" parameterType="int"> 
DELETE FROM ay user 


非 卖 品 ， 仅 供 非 商 业 用 途 或 交流 学 习 使 用 
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WHERE id = #{id} 
</delete> 
// 实 例 2: 根据 name 删除 记录 
<delete id="deleteByName" parameterType="String"> 
DELETE FROM ay user 
WHERE name = #{name} 
</delete> 


4.1.7 sql 元素 


sql 元 素 可 以 被 用 来 定义 可 重用 的 SQL 代码 段 ， 可 以 包含 在 其 他 语句 中 。 它 可 以 被 静态 地 
(在 加 载 参数 时 ) 参数 化 ， 比 如 有 一 条 SQL 语句 需要 查询 十 几 个 字段 映射 到 JavaBean 中 去 ， 而 
其 他 的 SQL 语句 也 有 类 似 的 需求 ， 重 复写 这 些 字段 显然 不 合理 ， 那 么 就 可 以 用 sql 元 素 对 这 些 
字段 进行 “封装 ”， 以 达到 重复 使 用 。 
下 面 来 看 几 个 具体 的 实例 : 


<sql id="userField"> 
Cio -to 
a.name as "name", 
a.Ppassword as "password" 
</sql> 
<!-= 获取 所 有 用 户 =--> 
<select id="findAll" resultType="com.ay.model.AyUser"> 
Select 
// 使 用 refid 进行 引用 
<include refid="userField"/> 
FOm av UsSer a 
</select> 


可 以 很 方便 地 使 用 include 元 素 的 refid 属性 进行 引用 ,还 可 以 使 用 定制 参数 来 使 用 sql 元 素 ， 
具体 代码 如 下 : 


<sql id="userField"> 
// 注 意 : 这 里 使 用 $ 符 合 而 不 是 # 符 号 ， 否 则 程序 出 现 异常 
SPDrefix} id as du 
$ {prefix}.name as "name", 
${prefix} .password as "password" 
</sql> 
<!-= 获取 所 有 有 用户 =-> 


<select id="findAll" resultType="com.ay.model.AyUser"> 
select 


非 卖 品 ， 仅 供 非 商 业 用 途 或 交流 学 习 使 用 
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<include refid="userField"> 
<property name="prefix" value="a"/> 
</include> 
from ay user a 
</select> 


4.1.8 # 与 $ 区 别 
4.1.7 节 中 的 SQL 语句 ， 使 用 ${fprefix} 而 不 使 用 #f prefix }， 它 们 之 间 的 区 别 是 : 


(1) # 介 将 传 入 的 数据 都 当成 一 个 字符 串 ， 会 对 自动 传 入 的 数据 加 一 个 双 引 号 ， 具 体 示例 
如 下 : 


order by #1{id} 
// 如 果 id 传 入 11， 则 sql 解析 成 : 
ONO ll 


(2) $ 人 将 传 入 的 数据 直接 显示 生成 在 sql 中 ， 有 具体 示例 如 下 : 


order by #{id} 
// 如 果 id 传 入 11， 则 sql 解析 成 : 
order by 11 


(3) # 方 式 能 够 很 大 程度 防止 sql 注入 ，$ 方 式 无 法 防止 sql 注入 。 
综 上 所 述 ， 一 般 建议 采用 #， 而 不 是 $。 


4.1.9 resultMap 结果 映射 集 


resultMap 结果 映射 集 是 Mybatis 中 重要 的 元 素 ， 它 的 作用 是 告诉 MyBatis 从 结果 集中 取出 
的 数据 转换 为 开发 者 所 需要 的 对 象 。resultMap 元 素 还 包含 其 他 的 元 素 ， 有 具体 如 下 : 


<resultMap> 
<constructor> /* 用 来 将 查询 结果 作为 参数 注入 到 实例 的 构造 方法 中 */ 
<idArg/> /* 标 记 结 果 作为 ID*/ 
<arg/> /* 标 记 结 果 作为 普通 参数 */ 
</constructor> 
<id/> /* 一 个 ID 结果 ， 标 记 结 果 作为 ID*/ 
<result/> /* 一 个 普通 结果 ，JavaBean 的 普通 属性 或 字段 */ 
<association> /* 关 联 其 他 的 对 象 */ 
</association> 
<collection> /* 关 联 其 他 的 对 象 集合 */ 
</collection> 
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非 卖 品 ， 仅 供 非 商 业 上 


j 途 或 交流 学 习 使 用 
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<discriminator> /* 鉴 别 器 ， 根 据 结果 值 进行 判断 ， 决 定 如 何 映射 */ 


<case></case> /* 结 果 值 的 一 种 情况 ， 将 对 应 一 种 映射 规则 */ 
</discriminator> 
</resultMap> 


先 来 看 一 个 具体 的 示例 ， 代 码 如 下 : 


<sql id="userField"> 
Snel Lo os cu, 
${prefix}.name as "name", 
${prefix}.password as "password" 
</sql> 
<resultMap id="userMap" type="com.ay.model.AyUser"> 
<id property="id" column="id"/> 
<result property="name" column="name"/> 
<result property="password" column="password"/> 
</resultMap> 


<select id="findAll" resultMap="userMap"> 
select 
<include refid="userField"> 
<property name="prefix" value="a"/> 
</includqe> 
from ay USer a 
</select> 


使 用 POJO 存储 结果 集 是 最 常用 的 方式 ， 也 是 推荐 的 方式 。resultMap 元 素 的 属性 id 代表 这 
个 resultMap 的 标识 ，type 代表 需要 映射 的 POJO。<id/> 元 素 表示 对 象 的 主键 ，property 代表 
POJO 的 属性 名 称 ，column 代表 数据 库 SQL 的 列 名 ， 这 样 POJO 和 数据 库 SQL 的 结果 就 一 一 对 
应 起 来 。 


result 和 id 两 个 元 素 共 有 的 属性 如 表 4-7 所 示 。 
表 4-7 result 和 id 元 素 属 性 配置 


属性 名 称 描 述 


property 


者 keyColumn 赋值 


令 MyBatis 使 用 JDBC 的 useGeneratedKeys 方法 来 获取 由 数据 库 内 部 生成 的 主键 ， 例 如 
MySQL 和 SQL Server 自动 递增 字段 ，Oracle 的 序列 等 ， 使 用 它 时 必须 给 keyProperty 或 


column 对 应 SQL 的 列 


javaType 配置 Java 的 类 型 ， 可 以 是 特定 的 类 完全 限定 名 或 者 MyBatis 上 下 文 的 别名 


非 卖 品 ， 仪 供 非 商业 用 途 或 交流 学 习 使 用 
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( 续 表 ) 
属性 名 称 描 述 
jdbcType 配置 数据 库 类 型 
类 型 处 理 器 , 允许 我 们 用 特定 的 处 理 器 来 覆盖 MyBatis 默认 的 处 理 器 。 这 要 制定 jdbcType 
和 javaType 相互 转化 的 规则 


其 他 的 元 素 ， 比 如 collection 、association 、discriminator 等 元 素 ， 将 会 在 后 续 的 章节 进行 


typeHandler 


4.2 动态 SQL 


4.2.1 动态 SQL 概述 


在 项 目 开发 过 程 中 ， 经 常 需要 根据 不 同 的 条 件 拼接 SQL 语句 ， 而 MyBatis 提供 了 对 SQL 
语句 动态 的 组 装 能 力 。MyBatis 采用 功能 强大 的 基于 OGNL 的 表达 式 来 完成 动态 SQL。 
常用 的 动态 SQL 元 素 如 表 4-8 所 示 。 


表 4-8 动态 SQL 元 素 


属性 名 称 描 述 
if 单条 件 分 支 判断 语句 
choose、when 和 otherwise 多 条 件 分 支 判断 语句 ， 相 当 于 Java 中 的 case when 语句 
trim, where, set 用 于 处 理 SQL 拼装 问题 ， 辅 助 元 素 
foreach 循环 语句 
直 .2 人 下 元 过 


论 元 素 主 要 用 来 做 判断 语句 ， 比 如 要 按照 名 称 name 查询 相关 的 用 户 ， 但 是 name 参数 是 可 
填 可 不 填 的 条 件 ， 如 果 用 户 没 有 填写 name 参数 ， 就 不 要 使 用 它 作为 查询 条 件 。 有 具体 看 下 面 的 
示例 : 


<sql id="userField"> 
bolyel I haelhly 
a.name as "name", 
a.password as "password" 
</sql> 
<resultMap id="userMap" type="com.ay.model.AyUser"> 
<id property="id" column="id"/> 
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* 非 商业 上 


j 途 或 交流 学 习 使 用 


<result property="name" column="name"/> 

<result property="password" column="password"/> 
</resultMap> 
// 通 过 用 户 名 name 和 密码 password 查询 用 户 
<select id="findByNameAndPassword" parameterType="String" 


resultMap="userMap"> 
SELECT 


<include refid="userField"></include> 

from ay user a 

WHERE 1 = 1 

<if test="name != null and name != ''"> 
and name = #{name} 


/TE> 
<if test="password != null and password != ''"> 
and password = #{password} 
/ale 
</select> 


对 应 的 AyUserDAO 接口 代码 如 下 : 


List<AyUser> findByNameAndPassword(@Param("name") String name, 
@Param("password") String password); 


让 标签 常常 与 test 属性 联合 使 用 且 是 必 先 属性。 上述 代 码 中 ， 通 过 判断 name 或 者 password 


参数 是 否 为 空 ， 如 果 不 为 空 ， 拼 凑 SQL 语句 进行 查询 。 如 果 为 空 ， 则 忽略 。 


4.2.3 choose、when、otherwise 元 素 


与 if 元 素 的 二 重 选 择 相 比 ，choose、when、otherwise 元 素 提 供 三 重 选择 ， 有 点 类 似 


Switch..case..default 语句 ， 有 具体 示例 代码 如 下 所 示 ; 


<sql id="userField"> 
a Nase, 
a.name as "name", 
a.password as "password" 
</sol> 
<resultMap id="userMap" type="com.ay.model .AyUser"> 
<id property="id" column="id"/> 
<result property="name" column="name"/> 


<result property="password" column="password"/> 
</resultMap> 


// 通 过 名 称 name 和 密码 password 查询 用 户 
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<select id="findByNameAndPassword" parameterType="String" 
resultMap="userMap"> 
SELECT 
<include refid="userField"></include> 
Biom eve use a 
WHERE 1 = 1 
<choose> 
<when test="name != null and name != ''"> 
and name = #{name} 
</when> 
<when test="password != null and password != ''"> 
and password = #{password} 
</when> 
<otherwise> 
ORDER BY id DESC 
</otherwise> 
</choose> 
</select> 


<choose> 标 签 里 可 以 包含 多 个 <when> 标 签 ，<otherwise> 标 签 是 可 选 的 并 不 是 必 填 选项 ， 


如 下 面 的 代码 : 


<select id="findByNameAndPassword" parameterType="String" 
resultMap="userMap"> 
SELECT 
<include refid="userField"></include> 


Brom oaVv USeree 


WHERE 1 = 1 
<choose> 
<when test="name != null and name != ''"> 


and name = #{name} 
</when> 
<when test="password != null and password != ''"> 
and password = #{password} 
</when> 
</choose> 
</select> 
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4.2.4 trim、where、set 元 素 


trim 是 更 灵活 地 用 来 去 处 多 余 关键 字 的 标签 ， 它 可 以 实现 where 和 set 的 效果 。 具 体内 容 看 
下 面 的 示例 : 


<select id="findByNameAndPassword" parameterType="String" 
resultMap="userMap"> 
SELECT 
<include refid="userField"></include> 
from ay user a ; 
<trim prefix="WHERE" prefixOverrides="AND"> 
<if test="name != null and name != ''"> 
and name = #{name} 
/E> 
<if test="password != null and password != ''"> 


and password = #{password} 


< /> 
</trim> 
</select> 
假如 name 和 password 字段 都 不 为 室 ， 上 面 的 代码 相当 于 如 下 的 SQL 语句 : 


SELECT 

a ic aS 

a.name as "name", 

a.password as "password" 

from ay User a 

WHERE name = #{name} and password = #{password} 


再 来 看 另外 一 个 示例 : 


<update id="update" parameterType="com.ay.model.AyUser"> 
UPDATE ay user 
<trim prefix="SET" suffixOverrides=", "> 
<if test="name != null and name != ''"> 
name = #{name}, 
</if> 
<if test="password != null and password != ''"> 
password = #{password}, 
< /E> 
</trim> 
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WHERE id = #{id} 
</update> 


假如 name 和 password 字段 都 不 为 空 ， 上 面 的 代码 相当 于 如 下 的 SQL 语句 : 


UPDATE ay user 

SE 

name = #{name}, 
password = #{password} 
WHERE id= #{id} 


trim 元 素 属性 配置 如 表 4-9 所 示 。 


表 4-9 trim 属性 元 素 配置 


属性 名 称 描 述 

表示 在 trim 标签 包 庄 的 部 分 前 面 添 加 内 容 。 注 意 : 是 在 没有 prefixOverrides， 
suffixOverrides 属性 的 情况 下 

prefixOverrides | 有 prefix 属性 的 情况 下 ， prefixOverrides 属性 表示 去 掉 SQL 语句 前 级 的 内 容 

表示 在 trim 标签 包 于 的 部 分 后 面 添加 内 容 。 注 意 : 是 在 没有 prefixOverrides， 
suffixOverrides 属性 的 情况 下 

suffixOverrides | 有 prefix 属性 的 情况 下 ，suffixOverrides 属性 表示 去 掉 SQL 语句 后 级 的 内 容 


编写 SQL 语句 的 时 候 ， 通 常 喜欢 写 这 样 的 SQL 语句 : 


<select id="findByName" parameterType="String" resultType= 


prefix 


suffix 


"com.ay.model .AyUser"> 
SEEECT * EROM ay Use WHERE YL = 1 
<if test="name != null and name != ''"> 
and name = #{name} 
</if 
</select> 


WHERE 1 = 1 这 样 的 条 件 显然 很 奇怪 ， 所 以 可 以 使 用 WHERE 标签 优化 上 面 的 SQL 语句 ， 
具体 代码 如 下 : 


<select id="findByName" parameterType="String" resultType= 
vcom,.ay.model AyUser"> 
SELECT * EROM ay User 
<where> 
<if test="name != nul and name != ”> 
and name = #{name} 
</if> 


仅 供 非 商 业 用 途 或 交流 学 习 使 / 


非 卖 品 ， 仅 供 非 商 业 用 途 或 交流 学 习 使 用 


88 | Spring MVC + MyBatis 快速 开发 与 项 目 实战 


</where> 
</select> 


这 样 当 where 元 素 里 面 的 条 件 成 立 的 时 候 ， 才 会 加 入 where 这 个 SQL 关键 字 到 组 装 的 SQL 
里 面 ， 和 否则 就 不 加 入 。 

set 元 素 在 执行 SQL 更 新 中 会 使 用 到 ， 先 来 看 一 个 传统 代码 写法 ， 具 体 如 下 : 

<update id="update" parameterType="com.ay.model.AyUser"> 


UPDATE ay user SET 
name = #{name}, 


password = #{password} 
WHERE id = #1{id} 
</update> 


上 面 代码 中 没有 使 用 set 元 素 ， 可 以 对 代码 进行 优化 ， 具 体 优化 后 的 代码 如 下 : 


<update id="update" parameterType="com.ay.model .AyUser"> 
UPDATE ay user 


<Set> 
<if test="name != null and name != ''"> 
name = #{name}, 
/if> 
<if test="password != null and password != ''"> 
password = #{password}, 
</ Lt> 
</set> 
WHERE id = #{id} 
</update> 


set 元 素 过 到 逗号 ， 它 会 把 对 应 的 逗号 去 掉 ， 比 如 上 面 代码 中 的 password = #{password}， 
不 需要 自己 写 判 断 语 句 去 除 召 号 。 


4.2.5 ”foreach 元 素 


foreach 元 素 是 一 个 循环 语句 ， 作 用 是 遍历 集合 ， 支 持 数组 、List、Set 等 。 具 体 看 下 面 的 示例 : 
// 根 据 Id 集合 查询 用 户 列表 


<select id="findBylIds" resultType="com.ay.model.AyUser"> 
SELECT RON ay UsSer 
WHERE id in 
<foreach item="item" index="index" collection="]ist" 


open="(" separator="," close=")"> 


4 
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#{item} 
</foreach> 
</select> 


foreach 属性 元 素 具体 的 配置 如 表 4-10 所 示 。 
表 4-10 foreach 属性 元 素 配 置 


属性 名 称 描 述 

item 循环 中 当前 的 元 素 

index 配置 的 是 当前 元 素 在 集合 的 位 置 下 标 

collection 接口 传递 进来 的 参数 名 称 ， 可 以 是 一 个 数组 、List、Set 等 集合 
open 配置 的 是 以 什么 符号 将 集合 中 的 元 素 包 装 起 来 ， 如 “(” 
separator 各 个 元 素 的 分 隔 符 

close 配置 的 是 以 什么 符号 将 集合 中 的 元 素 包 装 起 来 ， 如 “)” 


4.2.6 ”bind 元 素 


bind 元 素 可 以 从 OGNL 表达 式 中 创建 一 个 变量 并 将 其 绑 定 到 上 下 文 。 在 进行 模糊 查询 的 时 
候 ， 比 如 通过 用 户 名 称 name 查询 用 户 ， 就 常会 用 到 bind 元 素 ， 具 体 可 以 看 下 面 的 实例 : 


<select id="findByNameAndPassword" 


parameterType="String" resultType="com.ay.model.AyUser"> 
<bind name="name pattern" value="'%$' + name + '%$'"/> 
<bind name="password pattern" value="'%$' + password + '%'"/> 
SELECT * FROM ay user 
<where> 
<if test="name != null and name != ''"> 
and name LIKE #{name pattern} 
ATE> 
<if test="password != null and password != ''"> 
and password LIKE #{password pattern} 
< /i> 
</where> 
</select> 


上 述 的 select 元 素 中 ， 定 义 了 多 个 bind 元 素 ，bind 元 素 的 属性 value 的 值 : "%'+ password + 
'%m 会 赋值 给 name pattern， 然 后 就 可 以 在 SQL 中 直接 使 用 name_pattern 变量 。 
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4.3 MyBatis 注解 配置 


4.3.1 MyBatis 常用 注解 


在 前 面 的 章节 中 ，MySQL 的 映射 器 、 动 态 SQL 语句 等 知识 都 是 使 用 基于 XML 的 配置 方 
式 ， 其 实 除了 使 用 XML 的 配置 方式 ， 还 可 以 使 用 基于 注解 的 配置 方式 。MyBatis 提供 了 很 多 好 
用 的 注解 供 使 用 ， 有 具体 见 表 4-11。 


表 4-11 mybatis 常用 注解 
属性 名 称 描 述 
@Select 映射 查询 SQL 语句 
Select 语句 的 动态 SQL 映射 。 允 许 指 定 一 个 类 和 一 个 方法 在 执行 时 返回 运行 的 查询 
@SelectProvider | 语句 。 有 两 个 属性 : type 和 method，type 属性 是 类 的 完全 限定 名 ，method 是 该 类 中 
的 那个 方法 名 
@Delete 映射 删除 SQL 语句 
Delete 语句 的 动态 SQL 映射 。 允 许 指定 一 个 类 和 一 个 方法 在 执行 时 返回 运行 的 删除 
@DeleteProvider | 语句 。 有 两 个 属性 : type 和 method，type 属性 是 类 的 完全 限定 名 ，method 是 该 类 中 
的 那个 方法 名 
@Insert 映射 插入 SQL 语句 


(@InsertProvider 


Delete 语句 的 动态 SQL 映射 。 人 允许 指定 一 个 类 和 一 个 方法 在 执行 时 返回 运行 的 插入 
语句 。 有 两 个 属性 : type 和 method，type 属性 是 类 的 完全 限定 名 ，method 是 该 类 中 
的 那个 方法 名 


@Update 映射 更 新 SQL 语句 
Delete 语句 的 动态 SQL 映射 。 允 许 指定 一 个 类 和 一 个 方法 在 执行 时 返回 运行 的 更 新 
@UpdateProvider | 语句 。 有 两 个 属性 : type 和 method，type 属性 是 类 的 完全 限定 名 ，method 是 该 类 中 
的 那个 方法 名 
ss 列 和 属性 之 间 的 单独 结果 映射 。 属 性 包括 : id、column、 property、 javaType、 jdbcType、 
type、Handler、one、many。 其 中 id 属性 是 一 个 布尔 值 ， 表 示 是 否 被 用 于 主键 映射 
@Results | 多 个 结果 映射 《Result) 列表 
@Options | 提供 配置 选项 的 附加 值 ， 通 常 在 映射 语句 上 作为 附加 功能 配置 出 现 


@One 复杂 类 型 的 单独 属性 值 映射 
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属性 名 称 描述 

@Many | 复杂 类 型 的 集合 属性 映射 
当 映 射 器 的 方法 需要 多 个 参数 时 ， 注 解 可 以 被 应 用 于 映射 器 方法 参数 来 给 每 个 参数 取 
个 名 字 。 和 否则 ， 多 参数 默认 将 会 以 它们 的 顺序 位 置 和 SQL 语句 中 的 表达 式 进行 映射 


@Param 


4.3.2”@Select 注解 


@Select 注 解 与 XML 配置 里 的 select 标签 相对 应 ，@Results 注解 与 resultMap 标签 相对 应 ， 
当 在 AyUserDao 接口 中 使 用 注解 的 配置 方式 时 ， 就 不 需要 在 XML 里 面 配置 ， 具体 实例 如 下 
所 示 : 


@Repository 
public interface AyUserDao { 
// 实 例 1: 查询 所 有 的 用 户 列 表 
@Select ("SELECT * FROM ay user™,) 
List<AyUser> findAll (); 
// 实 例 2: 查询 所 有 的 用 户 列表 


CSelect(’ SELECT * EROM ay user ) 


QResults(t{ 
@Result (id = true,column = "id",property = "id"), 
QResult (column = "name",property = "name"), 
@Result (column = "password",property = "password") 


}) 

List<AyUser> findAll (); 

// 实 例 3: 通过 id 查询 用 户 

@Select ("SELECT * FROM av user WHERE id = #{1id}") 
AyUser findBylId(String id); 

// 实 例 4: 通过 用 户 名 获取 用 户 

@Select ("SELECT * FROM ay user WHERE name = #{name}") 
List<AyUser> findByName (String name); 


4.3.3 @Insert、@Update、@Delete 注解 


@Insert、@Update、@Delete 注解 与 XML 配置 里 的 insert、update、delete 标签 相对 应 ， 具 
体 实例 如 下 : 
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@Repository 
public interface AyUserDao { 
// 实 例 1: 插入 用 户 数 据 
@Insert ("INSERT INTO ay user (name,password) VALUES (#{name}, #{password})") 
@Options (UseGeneratedKeys = true, keyProperty = "id") 
int insert (AyUser ayUser); 
// 实 例 2: 更 新 用 户 数 据 
@Update ("UPDATE ay user SET name =#{name}, password = #{password} WHERE 
id = #1{id}") 
int update (AyUser ayUser); 
// 实 例 3: 根据 用 户 id 删除 用 户 
@Delete("DELETE FROM ay user WHERE id = #{id}") 
int delete(int id); 
// 实 例 4: 根据 用 户 名 删除 用 户 
GDpelete("”DEILETE FROM ay user WHERE name = #{name}") 
int deleteByName (String name); 


} 
@Options 注解 提供 配置 选项 的 附加 值 ， 通 常 在 映射 语句 上 作为 附加 功能 配置 出 现 。 


4.3.4”@Param 注解 

当 映 射 器 的 方法 需要 多 个 参数 时 ，@Param 注解 可 以 被 应 用 于 映射 器 方法 参数 来 给 每 个 参 
数 取 个 名 字 。 否 则 ， 多 参数 默认 将 会 以 它们 的 顺序 位 置 和 SQL 语句 中 的 表达 式 进行 映射 。 具 体 
实例 如 下 : 


@Select ("SELECT * FROM ay user WHERE name = #{name} and password = 


#{password}") 
List<AyUser> findByNameAndPassword(@Param ("name") String name, 
QParam("password") String password); 


除了 使 用 @Param 注解 映射 参数 之 外 ， 还 有 其 他 的 方式 来 映射 参数 ， 只 是 不 是 很 推荐 ， 这 
里 简单 的 总 结 一 下 其 他 的 方法 ， 读 者 可 以 做 简单 的 对 比 。 


1. Map 的 映射 方式 
AyUserDao 接口 的 方法 定义 如 下 : 
List<AyUser> findByNameAndPassword (Map<String, String > map); 


对 应 的 XML 配置 如 下 : 
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<select id="findByNameAndPassword" parameterType="java.util.Map" 
resultMap="uUserMap"> 


SELECR from ay USer a 


<where> 
<if test="name != null and name != ''"> 
and name = #{name} 
</if> 
<if test="password != null and password != ''"> 


and password = #{password} 
< /E> 
</where> 
</select> 


服务 层 AyUserServiceImpl 调用 方式 如 下 : 


public List<AyUser> findByNameAndPassword (Map<String,Sstring> map) { 
Map<String,String> map = new HashMap<String, String>(); 
map.put ("name","al™"); 
map.put ("password", "1237") 7 
return ayUserDao.findByNameAndPassword (map); 


} 
2. 顺序 映射 方式 


AyUserDao 接口 的 方法 定义 如 下 : 


List<AyUser> findByNameAndPassword(String name,Sstring password); 


对 应 的 XML 配置 如 下 : 


<select id="findByNameAndPassword" parameterType="String" 
resultMap="userMap"> 


SEC * fromay user a 
WHERE 1 = 1 AND name = #{paraml} AND password = #{param2} 


</select> 
顺序 映射 方式 是 通过 参数 的 顺序 进行 映射 的 ，name 参数 对 应 #{ param1}，#{password} 参 数 
对 应 param2， 当 然 这 是 新 版 的 Mybatis 提供 的 ， 旧 版 本 的 MyBatis 是 用 #{0}、#{1} 进 行 映射 的 。 
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4.4 MyBatis 关联 映射 


4.4.1 关联 映射 概述 


之 前 的 章节 中 ， 我 们 已 介绍 了 使 用 Mybatis 对 数据 库 单 表 进行 映射 和 执行 增删 改 查 操作 ， 
但 是 在 现实 的 项 目 中 进行 数据 库 建 模 时 ， 需 要 遵循 数据 库 设 计 范式 的 要 求 ， 对 现实 中 的 业务 模 
型 进行 拆 分 ， 封 装 到 不 同 的 数据 表 中 ， 表 与 表 之 间 存 在 着 一 对 多 或 多 对 多 的 对 应 关系 。 进 而 ， 
对 数据 库 的 增删 改 查 操作 的 主体 ， 也 就 从 单 表 变 成 了 多 表 。 那 么 Mybatis 中 是 如 何 实 现 这 种 多 
表 关 系 的 映射 呢 ? 这 是 接 下 来 要 学 习 的 重点 。 

关联 映射 大 致 可 以 分 为 : 一 对 一 、 一 对 多 、 多 对 多 ， 下 面 将 一 一 展开 描述 。 


4.4.2 一 对 一 


一 对 一 关联 关系 在 现实 生活 中 很 多 ， 比 如 : 一 个 人 只 能 有 一 个 身份 证 或 者 一 个 母亲 。 首 先 ， 
在 数据 库 springmvc-mybatis-book 中 创建 数据 库 表 ay user、ay_user address， 具 体 代 码 如 下 : 


DROP TABLE TF EXISTS ay usSer'; 
CREATE TABLE "ay user' (人 
'id' bigint (32) NOT NULL AUTO INCREMENT, 
'name' varchar(10) DEFAULT NULL, 
'password' varchar(64) DEFAULT NULL, 
'age' int(10) DEFAULT NULL, 
"address id' bigint(32) DEFAULT NULL, 
PRIMARY KEY (id"), 
Kh bacereSssicy (addnesseiau), 
CONSTRAINT 'FK address id' FOREIGN KEY ('address id') 
REFERENCES "ay user address' ('id') 
) ENGINE=INNoDB AUTO INCREMENT=5 DEFAULT CHARSET=utf8; 


DROP TABLE IE EXISTS 'ay user address'; 
CREATE TABLE "ay user address' ( 
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el nt (32) “NOT SNULI: 
'name' varchar (255) DEFAULT NULL, 
BRIMARY KRY (iG) 

) ENGINE=InnoDB DEFAULT CHARSET=utf8; 


表 ay_user、ay_user address 对 应 的 Model 代码 如 下 : 


/** 
* 用 户 实体 
* @author RAY 
* @date 2018/04/02 
zh 
public class AyUser implements Serializablef{ 
private Integer id; 
private String name; 
private String password; 
private Integer age; 
// 用 户 和 地 址 一 一 对 应 ， 即 一 个 用 户 只 有 一 个 老家 地 址 
private AyUserAddress ayUserAddress; 
// 省 略 set、get 方法 
} 
/大 大 
* 描述 : 用 户 地 址 实体 
x @author Ay 
* @create 2018/05/01 
*x*/ 
public class AyUserAddress implements Serializable { 


private Integer id; 
private String name; 


// 省 略 set、get 方法 
} 
用 户 和 老家 地 址 是 一 对 一 关系 ， 即 一 个 用 户 只 能 有 一 个 老家 地 址 。 在 AyUser 类 中 定义 一 
个 ayUserAddress 属性 ， 用 来 映射 一 对 一 的 关联 关系 ， 表 示 一 个 人 的 老家 地 址 。 
AyUser 类 和 AyUserAddress 类 创建 完成 之 后 ， 创 建 对 应 的 DAO 接口 AyUserDao 和 
AyUserAddressDao， 有 具体 代码 如 下 : 


@Repository 
public interface AyUserDao ({ 
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// 根 据 id 查询 用 户 
AyUser findqByIQq(Strzing id); 


@Repository 
public interface AyUserAddressDao { 
// 根 据 id 查询 用 户 地 址 


AyUserAddress findById(Integer id); 
} 


DAO 接口 AyUserDao 和 AyUserAddressDao 创建 完成 之 后 ， 继 续 创建 对 应 的 XML 配置 文 
件 AyUserMapper.xml 和 AyUserAddressMapper.xml，AyUserAddressMapper.xml 具体 代码 如 下 : 


<?xml] version="1.0" encoding="UTF-8" ?> 
<!DOCTYPE mapper PUBLIC "-//mybatis.org//DTD Mapper 3.0//EN" 
"http://mybatis.org/dtd/mybatis-3-mapper.dtd"> 
<mapper namespace="com.ay.dao.AyUserAddressDao"> 
<select id="findByld" 
parameterType="Integer”" resultType="com.ay.model.AyUserAddress"> 
SELECT * FROM ay user address WHERE id = #{id} 
</select> 


</mapper> 


AyUserMapper.xml 配置 文件 具体 代码 如 下 : 


<?xml version="1.0" encoding="UTF-8" ?> 
<!DOCTYPE mapper PUBLIC "“-//mybatis.org//DTD Mapper 3.0//EN" 
"http://mybatis.org/dtd/mybatis-3-mapper.dtd"> 


<mapper namespace="com.ay.dao.AyUserDao"> 


<resultMap id="userMap" type="com.ay.model.AyUser"> 
<id property="id" column="id"/> 
<result property="name" column="name"/> 
<result property="password" column="password"/> 
<association property="ayUserAddress" column="address id" 
select="com.ay.dao.AyUserAddressDao.findById" 
javaType="com.ay.model .AyUserAddress"> 
</association> 
</resultMap> 


<select id="findById" parameterType="String" resultMap="userMap"> 
SELECT * FROM ay user 
WHERE id = #{id} 
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</select> 


</mapper> 


AyUserAddressMapper.xml 配置 文件 中 通过 <selec 忆 标签 定义 了 一 个 通过 id 查询 地 址 的 简单 
查询 。AyUserMapper.xml 配置 文件 中 同样 也 配置 了 通过 id 查询 用 户 的 简单 查询 ， 查 询 返 回 的 结 
果 resultMap。resultMap 标签 通过 <association> 元 素 映 射 一 对 一 的 关联 关系 ，select 属 性 表示 会 使 
用 column 属性 的 address id 的 值 作为 参数 执行 AyUserAddressDao 中 定义 的 findById 方法 查询 
对 应 的 地 址 数据 ， 查 询 出 的 地 址 数据 被 封装 到 property 属性 的 ayUserAddress 对 象 当 中 。 这 样 一 
对 一 的 关联 映射 就 完成 了 。 


4.4.3 一 对 多 


一 对 多 关联 关系 在 现实 生活 中 也 有 很 多 ， 比 如 ， 一 个 学 校 可 以 包含 多 个 学 生 ， 一 个 学 生 只 
属于 一 个 学 校 ， 学 校 和 学 生 就 是 一 对 多 关系 ， 而 学 生 和 学 校 就 是 多 对 一 的 关系 。 首 先 ， 在 数据 
库 springmvc-mybatis-book 中 创建 数据 库 表 ay_student、ay_school， 有 具体 代码 如 下 : 


DROP TABLE TE EXISPTS ay suaenE，: 
CREATE TABLE "ay student' ( 
OF TIL, 

Imame' varchar (255) DEFAULT NULL, 
'age' int(2) DEFAULT NULL, 

'school id' bigint(32) DEFAULT NULL, 
PRIMARY KEY ('id') 

ENGINE=INNnoDB DEFAULT CHARSET=utf8; 


~ 一 


DROP TABLE IF EXISTS 2 ay School 
CREATE TABLE ‘'ay school' ( 
vc lo (SNOT NUL, 
name' varchar (255) DEFAULT NULL, 
PRIMARY KEY ('id') 
) ENGINE=InnoDB DEFAULT CHARSET=utf8; 
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数据 库 表 ay_student 和 ay_school 创建 完成 之 后 ， 接 着 创建 对 应 的 实体 类 AyStudent 和 
AySchool， 有 具体 代码 如 下 : 

/** 

* 描述 : 学 生 实体 

* Qauthor RAY 

x @create 2018/05/01 

x#/ 

public class AyStudent implements Serializable { 


private Integer id; 
private String name; 
private Integer age; 
// 一 个 学 生 只 能 在 一 个 学 校 
private AySchool aySchool; 
// 省 略 set、get 方法 

} 


一 个 学 生 只 能 在 一 个 学 校 里 ， 所 以 在 AyStudent 实体 里 维护 aySchool 属性 ，AySchool 实体 
类 的 代码 如 下 : 


/** 

* 描述 : 学 校 实体 

* @author Ay 

* @create 2018/05/01 

#x/ 

public class AySchool implements Serializable { 


private Integer id; 
private String name; 
// 一 个 学 校 有 多 个 学 生 


private List<AyStudent> students; 


// 省 略 set、get 方法 
} 


一 个 学 校 里 面 有 很 多 的 学 生 ， 所 以 在 AySchool 实体 类 中 维护 students 的 集合 列表 ， 该 集合 
列表 是 一 个 List 对 象 。 实 体 类 AyStudent 和 AySchool 创建 完成 之 后 ， 继 续 创建 AyStudentDao 
和 AySchoolDao 接口 ， 具 体 代 码 如 下 : 
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/** 

* 描述 : 学 生 DAO 接口 

* @author Ay 

* @create 2018/05/01 

大 大 / 

public interface AyStudentDao { 
List<AyStudent> findBySchoolId(Integer id) ， 


/** 

* 描述 : 学 校 DAO 接口 

* Qauthor Ay 

* Q@create 2018/05/01 

炎炎/ 
public interface AySchoolDao { 


AySchool findByld(Integer id); 
} 


AyStudentDao 和 AySchoolDao 接口 创建 完成 之 后 ， 创 建 对 应 的 XML 配置 文件 ， 
AyStudentMapper.xml 具体 代码 如 下 : 


<?xml version="1 .0 encoding="UTFE-8" ?> 
<!IDOCTYPE mapper PUBLIC "-//mybatis.org//DTD Mapper 3.0//EN" 
"http://mybatis.org/dtd/mybatis-3-mapper.dtd"> 
<mapper namespace="com.ay.dao.AyStudentDao"> 
<resultMap id="studentMap" type="com.ay.model.AyStudent"> 
<id property="id" column="id"/> 
<result property="name" column="name"/> 
<result property="age" column="age"/> 
<association property="aySchool" javaType="com.ay.model.AySchool"> 
<id property="id" column="id"/> 
<result Property="name" column="name"/> 
</association> 
</resultMap> 
<! -- 根据 id 查询 学 生 ， 关 联 ay_school 表 --> 
<select idq="findqById" parameterType="Integer" resultMap="studentMap"> 
SnLnCr FROV ay Stuaente ls 7 ascnool © 
WERRHRS SCNhool Ld = GLd 
AND s.id = #{id} 
</select> 


非 卖 品 ， 仅 供 非 商业 用 途 或 交流 学 习 使 
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<! -- 根据 学 校 iq 查询 学 生 --> 
<select id="findBySchoolId" 
parameterType="Integer" resultType="com.ay.model.AyStudent"> 
SELECT * FROM ay student WHERE school id = #{school id)} 
</select> 


</mapper> 


在 AyStudentMapper.xml 配置 文件 中 ， 使 用 <select> 标 签 ， 通 过 id 查询 学 生 实体 ， 同 时 关联 
了 ay_school 表 ， 碍 询 结果 返回 到 studentMap 中 。 在 studentMap 中 ， 使 用 < association > 元 素 映 
射 多 对 一 的 关联 关系 。 因 为 <select id="findById" ..> 的 SQL 语句 是 一 条 多 表 连 接 ， 在 查询 学 生 的 
同时 ， 会 把 对 应 的 学 校 查询 出 来 。 

AySchoolMapper.xml 具体 代码 如 下 : 


<?xml] version="1.0" encoding="UTF-8" ?> 

<!DOCTYPE mapper PUBLIC "-//mybatis.org//DTD Mapper 3.0//EN" 
"http://mybatis.org/dtd/mybatis-3-mapper.dtd"> 

<mapper namespace="com.ay.dao.AySchoolDao"> 


<resultMap id="schoolMap" type="com.ay.model.AySchool"> 
<id property="id" column="id" /> 
<result property="name" column="name"/> 
<collection property="students" javaType="ArrayList" column="id" 
ofType="com.ay.model .AyStudent" 
fetchType="lazy" 
select="com.ay.dao.AyStudentDao.findBySchoolId"> 
<id property="id" column="id"/> 
<result property="name" column="name"/> 
<result property="age" column="age"/> 
</collection> 
</resultMap> 


<!-- 根据 id 查询 学 校 --> 


<select id="findById" parameterType="Integer" resultMap="schoolMap"> 
SELECT * FROM ay_ school WHERE id = #{id} 
</select> 
</mapper> 


在 AySchoolMapper.xml 配置 文件 中 ， 使 用 <selecP> 标 签 ， 通 过 id 查询 学 校 实体 ， 返 回 结果 
到 schoolMap 中 。 在 resultMap 中 ， 使 用 <collection> 元 素 映 射 一 对 多 的 关联 关系 ，select 属性 表 


示 会 使 用 column 属性 的 id 值 作为 参数 执行 AyStudentDao 接口 中 的 findBySchoolld 查询 该 学 校 
下 所 有 的 学 生 数 据 ， 查 询 出 的 数据 将 被 封装 到 property 表示 的 students 对 象 中 。 


仅 供 非 商业 用 途 或 交流 学 习 使 用 


非 卖 品 ， 仪 供 非 商业 | 


j 途 或 交流 学 习 使 用 
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4.4.4 多 对 多 
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多 对 多 关联 关系 在 现实 生活 中 也 有 很 多 ， 比 如 ， 用 户 和 角色 的 关系 ， 一 个 用 户 可 以 有 多 个 
角色 ， 每 个 角色 也 可 以 有 多 个 用 户 ; 学 生 和 老师 的 关系 ， 一 个 学 生 可 以 跟 多 个 老师 ， 每 个 老师 
也 可 以 教 多 个 学 生 等 。 首 先 ， 在 数据 库 springmvc-mybatis-book 中 创建 数据 库 表 ay_user、 


ay_role、ay_user role_rel， 具 体 代码 如 下 : 


DROP TABLE IE EXISTS "ay user'; 
CREATE TABLE ay user ( 
'id' bigint(32) NOT NULL AUTO INCREMENT, 
'name’' varchar(10) DEFAULT NULL, 
'password' varchar(64) DEFAULT NULL, 
'age' int(10) DEFAULT NULL, 
"address id' bigint(32) DEFAULT NULL, 
PRIMARY KEY ('id'), 
KEY EK address lid (vaddresSsmld |) 区 
CONSTRAINT 'FK address id' FOREIGN KEY ('address id') 
REFERENCES ‘'ay user address' ('id') 
) ENGINE=InnoDB AUTO INCREMENT=5 DEFAULT CHARSET=utf8; 


DROP TABLE IF EXISTS "ay role'; 
CREATE TABLE "ay role' (人 
id" bligint(32) NOT NUELD; 
'name' varchar (255) DEFAULT NULL, 
PRIMARY KEY ('id') 
) ENGINE=InnoDB DEFAULT CHARSET=utf8; 


DROP TABRR EE EXESTON ay USer Oe LOLS 
CREATR. TABERL. ay USeI Pole rel. ( 
"id bigint (32) NOT NULL, 


仅 供 非 商业 用 途 或 交流 学 习 使 用 
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UUSEE 


PRIMARY KEY (id') 


DEFAULT NULL, 
'role Td! bigint(32) DEFAULT NULE, 


) ENGINE=INNnoDB DEFAULT CHARSET=utf£8; 


数据 库 表 ay_user、ay_role 、ay_user role rel 创建 完成 之 后 ， 创 建 对 应 的 实体 对 象 
AyUser、AyRole、AyUserRoleRel， 有 具体 代码 如 下 所 示 : 


/大 大 

* 用 户 实体 

* @author Ay 

* @date 2018/04/02 
#3 


public class AyUser implements Serializable{ 


private Integer id; 


private String name; 


private String passworgd; 


private Integer age; 
// 用 户 与 角色 是 多 对 多 关系 ， 一 个 用 户 有 多 个 角色 
private List<AyRole> ayRoleList; 


/** 
描述 : 角色 实体 


* 


* 

* Qauthor Ay 

* Qcreate 2018/05/01 
**/ 


public class AyRole implements Serializable { 


private Integer id; 


private String name; 
// 和 角色 与 用 户 是 多 对 多 关系 ， 一 个 角色 对 应 多 个 用 户 


private List<AyUser> ayUserList; 


/** 

* 描述 : 用户 角色 关联 实体 
x @author Ay 

* @create 2018/05/01 
**)/ 


仅 f 


t 非 商业 


途 或 交流 学 习 使 用 


jj 途 或 交流 学 习 使 用 


非 卖 品 ， 仅 供 非 商业 用 途 或 交流 学 习 使 
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Public class AyUserRoleRel implements Serializable { 


private Integer id; 

ZW 肝 忆 ia 

private Integer userld; 
// 和 角色 id 

private Integer roleld; 


} 


用 户 和 角色 是 多 对 多 关联 关系 ， 在 AyUser 实体 对 象 中 定义 List<AyRole> ayRoleList 角色 属 
性 ， 用 来 维护 用 户 和 角色 的 关系 。 同 理 ， 在 AyRole 实体 对 象 中 定义 List<AyUser> ayUserList 用 
户 属性 ， 用 来 维护 角色 与 用 户 的 关系 。 实 体 对 象 AyUser、AyRole、AyUserRoleRel 创建 完成 之 
后 ， 创 建 对 应 的 DAO 接口 对 象 ， 具 体 代码 如 下 : 


@Repository 
public interface AyUserDao { 
AyUser findBylId(String id); 


@Repository 

public interface AyRoleDao { 
AyRole findById(String id); 

} 


AyUserDao 和 AyRoleDao 接口 创建 完成 之 后 ,创建 对 应 的 XML 配置 文件 
AyUserMapper.xml 和 AyRoleMapper.xml，AyUserMapper.xml 配置 文件 的 具体 代码 如 下 所 示 : 


<?xrm]l Version="1.0" encoding="UTF-8" ?> 

<!IDOCTYPE mapper PUBLIC "-//mybatis.org//DTD Mapper 3.0//EN" 
"nttp://mybatis.org/dtd/mybatis-3-mapper.dtd"> 

<mapper namespace="com.ay.dao.AyUserDao"> 


<resultMap id="userMap" type="com.ay.model.AyUser"> 

<id property="id" column="id"/> 

<result property="name" column="name"/> 

<result property="password" column="password"/> 

<collection property="ayRoleList" javaType="ArrayList" column="id" 
ofType="com.ay.model .AyRole" 
fetchType="lazy" 
select="com.ay.dao.AyRoleDao.findByUserId"> 

<id property="id" column="id"/> 


EE 
仅 供 非 商业 用 途 或 交流 学 习 使 用 wy 


非 卖 品 ， 仅 供 非 商 业 用 途 或 交流 学 习 使 用 
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将 


<result property="name" column="name"/> 
</collection> 
</resultMap> 


<select id="findBylId'" parameterType="String" resultMap="userMap"> 
SHERC * FROM ay USer 
WHERE id = #1{id} 

</select> 


<select id="findByRoleld" parameterType="Integer" 
resultType="com.ay.model .AyUser"> 
SELECT * FROM ay user WHERE id in( 
SETeoGE USer LO ErOnN dy USene roles EOI Wicre nmol horerg 
) 
</select> 
</mapper> 


AyRoleMapper.xml 配置 文件 的 具体 代码 如 下 所 示 : 


<?xml version="1.0" encoding="UTF-8" ?> 
<!IDOCTYPE mapper PUBLIC "-//mybatis.org//DTD Mapper 3.0//EN" 
"http://mybatis.org/dtd/mybatis-3-mapper.dtd"> 


<mapper namespace="com.ay.dao.AyRoleDao"> 


<resultMap id="roleMap" type="com.ay.model.AyRole"> 
<id property="id" column="id"/> 
<result property="name" column="name"/> 
<collection property="ayUserList" javaType="ArrayList" column="id" 
ofType="com.ay.model .AyUser" 
fetchType="lazy" 
select="com.ay.dao.AyUserDao.findByRoleld"> 
<id property="id" column="id"/> 
<result property="name" column="name"/> 
<result property="password" column="password"/> 
</collection> 
</resultMap> 
<select id="findByld" parameterType="String" resultMap="roleMap"> 
SELECT * FROM ay role WHERE id = #{id} 
</select> 
<select id="findByUserId" parameterType="Integer" 
resultType="com.ay.model .AyRole"™> 


CN 
仅 供 非 商 业 用 途 或 交流 学 习 使 用 


非 卖 品 ， 仅 供 非 商业 用 途 或 交流 学 习 使 用 
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SELECT * FROM ay role WHERE id in( 
Select role Td fronmsaynusersncoenel where ser na 此 人 asecEO 
) 
<Aselect> 
</mapper> 


在 AyUserMapper.xml 配置 文件 中 ， 通 过 <select> 标 签 查询 用 户 信息 ， 将 返回 的 结果 存放 到 
userMap 中 。userMap 中 定义 <collection> 元 素 映 射 一 对 多 的 关联 关系 ，select 属性 表示 会 使 用 
column 属性 的 id 值 作 为 参数 执行 AyRoleDao 接口 中 的 findByUserId 方 法， 查询 出 的 数据 将 被 封 
装 到 property 表示 的 ayRoleList 对 象 当中 。 

在 AyRoleMapper.xml 配置 文件 中 ， 通 过 <select 标 签 查询 角色 信息 ， 将 返回 的 结果 存放 到 
roleMap 中 。roleMap 中 定义 <collection> 元 素 映 射 一 对 多 的 关联 关系 ，select 属性 表示 会 使 用 
column 属性 的 id 值 作为 参数 执行 AyUserDao 接口 中 的 findByRoleld 方法， 查询 出 的 数据 将 被 封 
装 到 property 表示 的 ayUserList 对 象 当中 ，fetchType="lazy" 表 示 使 用 懒 加 载 的 方式 加 载 数 据 。 

开启 懒 加 载 模 式 ， 需 要 在 mybatis-config.xml 配置 文件 中 添加 如 下 代码 : 


<?2xml] version="1.0" encoding="UTF-8" ?> 
<!DOCTYPE configuration 
PUBLIC "-//mybatis.org//DTD Config 3.0//EN" 
"http://mybatis.org/dtd/mybatis-3-config.dtd"> 
<configuration> 
<!-- 全 局 配置 参数 ， 需 要 时 再 设置 --> 
<settings> 
// 省 略 代码 
<!-- 通过 日 志 记 录 显 示 mybatis 的 执行 过 程 =-> 
<setting name="logImpl" value="1og4j" /> 
<!-- lazyLoadingEnabled 设置 为 懒 加 载 --> 
<setting name="lazyLoadingEnabled" value="true"/> 
<!-- aggressiveLazyLoading 主动 加 载 为 false --> 
<setting name="aggressiveLazyLoading" value="false"/> 
</settings> 
</configuration> 


仅 供 非 商 业 用 途 或 交流 学 习 使 用 LD 


非 卖 品 ， 仅 供 非 商业 用 途 或 交流 学 习 使 


MyBatis 分 页 开发 


本 章 将 介绍 MyBatis 提供 的 RowBounds 分 页 的 使 用 和 原理 ， 以 及 分 页 插件 PageHelper 的 使 
用 和 原理 。 


5.1 RowBounds 分 页 


5.1.1 分 页 概述 


分 页 查询 ， 就 是 将 数据 库 查 询 的 结果 在 有 限 的 界面 上 分 好 多 页 显示 ， 分 页 是 许多 网 站 常用 
的 功能 ， 也 是 最 基本 的 功能 。 分 页 查询 可 分 为 逻辑 分 页 和 物理 分 页 。 

e 还 辑 分 页 : 依赖 程序 员 编 写 的 代码 ， 数 据 库 返回 的 不 是 分 页 结果 ， 而 是 全 部 数据 ， 然 
后 再 由 程序 员 通 过 代码 获取 分 页 数据 。 常 用 的 操作 是 一 次 性 从 数据 库 中 查询 出 全 部 数 
据 并 存储 到 List 集 合 中 ， 因 为 List 集 合 有 序 ， 再 根据 索引 获取 指定 范围 的 数据 。 

@ 物理 分 页 : 使 用 数据 库 自身 所 带 的 分 页 机 制 ， 例 如 ，Oracle 数 据 库 的 rownum， 或 者 
MYSQL 数据库 中 的 limit 等 机 制 来 完成 分 页 操作 。 因 为 是 对 数据 库 实 实 在 在 的 数据 进行 
分 页 条 件 查询 ， 所 以 叫 物理 分 页 。 每 一 次 物理 分 页 都 会 去 连接 数据 库 。 


物理 分 页 优 于 逻辑 分 页 ， 我 们 没有 必要 将 属于 数据 库 端 的 压力 施加 到 应 用 端 来， 所 以 建议 
读者 在 日 常 工作 中 尽量 使 用 物理 分 页 而 不 是 逻辑 分 页 。 


仅 供 非 商业 用 途 或 交流 学 习 使 用 


出 对 氏 专 聂 演 多 村 出 下 出 非 祖 训 
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5.1.2 RowBounds 分 页 


MyBatis 提供 可 以 进行 逻辑 分 页 的 RowBounds 类 ， 通 过 传递 RowBounds 对 象 ， 来 进行 数据 
库 数 据 的 分 页 操作 ， 任 何 select 语句 都 可 以 使 用 它 。 然 而 遗憾 的 是 该 分 页 操作 是 对 ResultSet 结 
果 集 进行 分 页 ， 也 就 是 人 们 常 说 的 逻辑 分 页 而 非 物理 分 页 , 它 会 用 一 条 SQL 中 查询 所 有 的 结果 ， 
然后 根据 从 第 几 条 到 第 几 条 取出 数据 返回 。 首 先 ， 我 们 先 来 看 一 下 RowBounds 类 的 源码 ， 具 体 代 
码 如 下 : 
/** 
* Qauthor Clinton Begin 
6 
public class RowBounds { 


public static final int NO ROW OFFSET = 0; 
public static final int NO ROW LIMIT = Integer.MAX VALUE; 
public static final RowBounds DEFAULT = new RowBounds(); 


private final int offset; 


private final int Bimity 


public RowBounds() { 
this.offset = NO ROW OFFSET; 
Eusasme NOPROW DEMETS; 

} 


// 构 造 函 数 
public RowBounds (int offset, int limit) { 
this.offset = offset; 
this.Iimit = limit; 


} 


PUbLic int getOftset() 
return Offsety; 


} 


public int getLimit() { 


return limit; 


骤 区 去 联 妆 首 芍 出 王刚 非 神 让 “中 兰 非 


非 卖 品 ， 仅 供 非 商业 用 途 或 交流 学 习 使 
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在 RowBounds 源 码 中 ， 定 义 了 offset 和 1limit 两 个 参数 。offset 表 示 从 第 几 行 开始 读 取 数据 。 
limit 表示 限制 返回 的 记录 数 。 从 源码 还 可 以 看 出 offset 默认 值 为 0 (NO_ROW_OFFSET =0) ， 
Limit 默认 值 为 Java 允许 的 最 大 整数 (NO ROW _LIMIT = Integer.MAX VALUE) 。 在 数据 量 大 
的 情况 下 ， 将 数据 一 次 性 查询 出 来 ， 这 对 内 存 消耗 影响 很 多 ， 会 造成 内 存 溢出 的 问题 。 


5.1.3 RowBounds 分 页 使 用 


首先 ， 在 AyUserMapper.xml 配置 文件 中 添加 select 查询 ， 有 具体 代码 如 下 所 示 : 


<sql id="userField"> 
so Chl tel 
a.name as "name"， 
a.password as "password"™ 
</sql> 
// 查 询 所 有 的 用 户 
<select id="findAll" resultMap="userMap"> 
select 
<include refid="userField"/> 
from ay USer a 
</select> 


然后 ， 在 AyUserDao 接口 中 添加 对 应 的 查询 方法 findAll，findAll 方法 入 参 是 RowBounds， 
具体 代码 如 下 所 示 : 


@Repository 

public interface AyUserDao { 

List<AyUser> findAll (RowBounds rowBounds); 
// 省 略 其 他 代码 

} 


最 后 ， 在 AyUserDaoTest 测试 类 中 添加 测试 方法 testFindAllI0， 有 具体 代码 如 下 : 


/** 

* 描述 : 用 户 DAO 测试 类 
* Qauthor Ay 

* @create 2018/05/04 


**/ 


public class AyUserDaoTest extends BaseJunit4Test{ 


@Resource 


private AyUserDao ayUserDao; 


仅 供 非 商 业 用 途 或 交流 学 习 使 / 
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@Test 
publieo voLrd testEindAlLl() Tt 
List<AyUser> userList = ayUserDao.findAll (new RowBounds (0, 5)); 
for(AyUser ayUser: userList)t{ 
System.out .Println("name: " + ayUser.getName ()); 


} 

代码 全 部 开发 完成 之 后 ， 运 行 测试 方法 testFindAll， 便 可 以 在 控制 台中 看 到 打印 信息 : 

ho 

name: 阿兰 

Gt 

name: 阿 数 

ae 有 

name: Ay 

RowBounds 分 页 在 任何 select 语句 中 都 可 以 使 用 ， 但 是 它 是 在 SQL 查询 出 所 有 结果 的 基础 
上 截取 数据 的 ， 对 于 大 数据 量 返回 的 SQL 中 并 不 适用 。RowBounds 分 页 适合 返回 数据 结果 较 少 
的 查询 。 


5.1.4 RowBounds 分 页 原理 


上 一 节 中 ， 我 们 已 经 知道 RowBounds 分 页 是 一 个 逻辑 分 页 ， 这 一 节 主 要 学 习 RowBounds 是 如 
何 来 进行 分 页 的 。 首 先 看 DefaultSqlSession 类 中 的 查询 接口 ， 部 分 源码 如 下 所 示 : 


<E> List<E> selectList(String statement, Object parameter); 


<E> List<E> selectList(String statement, Object parameter, 
RowBounds rowBounds); 


从 源码 可 以 看 出 ，DefaultSqlSession 提供 的 查询 接口 是 以 RowBounds 作为 参数 用 来 进行 分 
页 的 。 
再 来 看 DefaultResultSetHandler 类 的 源码 ， 该 类 主要 是 对 查询 结果 集 进 行 处 理 的 类 ， 部 分 
源码 如 下 所 示 : 
private void handleRowValuesForSimpleResultMap (ResultSetWrapper rsw, 
ResultMap resultMap,ResultHandler<?> resultHandler, 


RowBounds rowBounds,ResultMapping parentMapping)throws 
SQLException { 
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DefaultResultContext<Object> resultContext 
= new DefaultResultContext<Object>(); 
// 跳 到 offset 位 置 ， 准 备 读 取 数 据 
SkipRows (rsw.getResultSet(), rowBounds); 
//while 循环 判断 是 否 小 于 1imit 值 ， 如 果 是 ， 读 取 1imit 条 数据 
while (shouldProcessMoreRows (resultContext, rowBounds) 
&& rsw.getResultSet() .next()) { 
ResultMap discriminatedResultMap = 
resolveDiscriminatedResultMap (rsw.getResultset (), 
resultMap, null)s 

Object rowValue = getRowValue (rsw, discriminatedResultMap); 
storeObject (resultHandler, resultContext, 

rowValue, parentMapping, rsw.getResultSset()); 


private void skipRows (ResultSet rs, RowBounds rowBounds) throws 
SQLException { 


T(rondet lype( = Resultset TYPE FORWARDNONIY)N 
if (rowBounds.getOffset() != RowBounds.NO ROW OFFSET) { 
// 直 接 定 位 


rs.absolute (rowBounds.getOffset ()); 
) 
} else { 
// 通 过 循环 ， 跳 到 offset 位 置 ， 进 行 读 取 
for (int i = 0; i < rowBounds.getOffset(); i++) { 
rs.next(); 


} 


从 源码 可 以 看 出 ，RowBounds 在 处 理 分 页 时 只 是 简单 地 把 offset 之 前 的 数据 都 skip 掉 ， 超 
过 limit 之 后 的 数据 不 取出 。 跳 过 offset 之 前 的 数据 是 由 方法 skipRows 处 理 ， 判 断 数据 是 否 超过 
了 limit 则 是 由 shouldProcessMoreRows 方法 进行 判断 。 简 单 来 说 ， 就 是 先 把 数据 全 部 查询 到 
ResultSet， 然 后 从 ResultSet 中 取出 offset 和 limit 之 间 的 数据 ， 实 现 了 分 页 查询 。 
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5.2 分 页 插件 PageHelper 


5.2.1 PageHelper 概述 


PageHelper 是 一 款 开源 免费 的 Mybatis 物理 分 页 插件 。PageHelper 插件 可 以 方便 地 实现 物理 
分 页 ， 与 RowBounds 分 页 方式 相 比 ，PageHelper 在 查询 性 能 方面 ， 更 胜 一 筹 。PageHelper 的 
github 地 址 : https://github.com/pagehelper/Mybatis-PageHelper， 读 者 可 访问 该 地 址 下 载 相关 的 文档 
和 资料 。 


5.2.2 PageHelper 使 用 


PageHelper 使 用 非常 简单 ， 首 先 ， 在 项 目的 pom.xml 文件 添加 PageHelper 依赖 包 ， 上 有 具体 代 
码 如 下 所 示 : 


<dependency> 
<groupId>com.github.pagehelper</groupld> 
<artifactId>pagehelper</artifactId> 
<version>5.1.4</version> 


</dependency> 


依赖 添加 完成 之 后 ， 在 applicationContext.xml 配置 文件 中 添加 PageHelper 相关 配置 ， 具 体 
代码 如 下 : 


// 省 略 代码 

!--3、 配 置 SqlSessionFactory 对 象 --> 

<bean id="sqlSessionFactory" 

class="org.mybatis.spring.SqlSessionFactoryBean"> 
<!-- 注 入 数据 库 连 接 池 --> 
<property name="dataSource" ref="dataSource"/> 
<1-- 扫 描 sql 配置 文件 :mapper 需要 的 xml 文件 --> 


<property name="mapperLocations" value="classpath:mapper/*.xml"/> 


<!-- 配置 分 页 插件 --> 
<property name="plugins"> 
<array> 
<bean class="com.github.pagehelper.PagelInterceptor"> 


<property name="properties"> 
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<value> 
<! 一 - 数据 库 类 型 为 mysql --> 
helperDialect=mysql 
<!-- 启用 合理 化 时 ， 如 果 pageNum <1 会 查询 第 一 页 ， 如 果 
pageNum > pages 会 查询 最 后 一 页 --> 
<!-- 禁用 合理 化 时 ， 如 果 pageNum < 1 或 pageNum > pages 
会 返回 空 数据 --> 
reasonable=true 
</value> 
</property> 
</bean> 
</array> 
</property> 
</bean> 


// 省 略 代码 
配置 添加 完成 之 后 ， 在 AyUserDaoTest 开发 测试 用 例 ， 有 具体 代码 如 下 : 


GTest 
public void testPageHelper(){ 
//startPage (第 几 页 ， 多 少 条 数据 ) 
PageHelper.startPage (0, 1);，; 
// 查 询 所 有 用 户 
List<AyUser> userList = ayUserDao.findAll (); 
// 用 PageInfo 对 结果 进行 包装 
PageInfo PageInfo = new PageInfo(userList) ; 
} 


PageHelper 使 用 非常 简单 ， 在 需要 进行 分 页 的 Mybatis 方法 前 调用 PageHelper.startPage 静 
态 方法 即 可 ， 紧 跟 在 这 个 方法 后 的 第 一 个 Mybatis 查询 方法 会 被 进行 分 页 ， 然 后 分 页 插件 会 把 
分 页 信息 封装 到 PageInfo 中 。PageInfo 包含 了 非常 全 面 的 分 页 属性 ，PageInfo 具体 源码 如 下 
所 示 : 


public class PageInfo<T> extends PageSerializable<T> { 
// 当 前 页 
private int pageNum; 
// 每 页 的 数量 
Private int pageSize; 
// 当 前 页 的 数量 


private int size; 
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// 由 于 startRow 和 endqRow 不 常用 ， 这 里 介绍 一 个 具体 的 用 法 
// 可 以 在 页 面 中 "显示 startRow 到 endRow 共 size 条 数据 " 


// 当 前 页 面 第 一 个 元 素 在 数据 库 中 的 行 号 
private int startRow; 

// 当 前 页 面 最 后 一 个 元 素 在 数据 库 中 的 行 号 
private int endRow; 

// 总 页 数 


private int pages; 


// 前 一 页 

private int prePage; 
El 

private int nextPage; 


// 是 否 为 第 一 页 

private boolean isFirstPage = false; 
// 是 否 为 最 后 一 页 

private boolean isLastPage = false; 
// 是 否 有 前 一 页 

private boolean hasPreviousPage = false; 
// 是 否 有 下 一 页 

private boolean hasNextPage = false; 
// 导 航 页 码 数 

private int navigatePages; 

// 所 有 导航 页 号 

private int[] navigatepageNums; 

// 导 航 条 上 的 第 一 页 

private int navigateFirstPage; 

// 导 航 条 上 的 最 后 一 页 


private int navigateLastPage; 


// 省 略 代码 


Spring MVC 常用 注解 


本 章 将 介绍 Spring MVC 常用 注解 ， 包 括 请 求 映 射 注解 和 参数 绑 定 注解 以 及 Spring MVC 信 
息 转 换 的 原理 。 


6.1 ”请求 映射 注解 


6.1.1”@Controller 注解 


在 SpringMVC 中 ， 控 制 器 Controller 负责 处 理由 DispatcherServlet 分 发 的 请 求 ， 它 把 用 户 请 
求 的 数据 经 过 业务 处 理 层 处 理 之 后 封装 成 一 个 Model， 然 后 再 把 该 Model 返回 给 对 应 的 View 视 
图 层 进行 展示 。 在 Spring MVC 中 提供 了 一 个 非常 简便 的 定义 Controller 的 方法 ， 你 无 需 继承 特定 
的 类 或 实现 特定 的 接口 ， 只 需 使 用 @Controller 标记 一 个 类 是 Controller， 然 后 使 用 
@RequestMapping 和 @RequestParam 等 一 些 注解 用 以 定义 URL 请 求 和 Controller 方法 之 间 的 映 
射 ， 这 样 的 Controller 就 能 被 外 界 访问 到 。 此 外 Controller 不 会 直接 依赖 于 HttpServletRequest 和 
HttpServletResponse 等 HttpServlet 对 象 ， 它 们 可 以 通过 Controller 的 方法 参数 灵活 地 获取 到 。 为 
了 对 Controller 有 一 个 初步 的 印象 ， 以 下 先 定 义 一 个 简单 的 Controller， 具 体 源码 如 下 所 示 : 
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/** 

* 用 户 控制 层 

*@author Ay 

x @date 2018/04/02 

A 

@Controller 

@RequestMapping (value = "/user") 
public class AyUserController { 


@GetMapping("/hello") 

public String hello(Model model) { 
model.addAttribute("message", "hello ay"); 
return "hello"; 


} 


上 述 代码 定义 了 一 个 AyUserController 控制 层 ， 使 用 @Controller 注解 进行 表示 ， 使 用 
@GetMapping 注解 来 映射 一 个 请 求 ，value=“/hello”。 为 了 保证 Spring 能 够 找到 控制 层 ， 需 要 
额外 进行 配置 : 在 applicationContext.xml 配置 文件 中 配置 <context:component-scan /> 元 素 ， 如 果 
已 经 配置 可 以 略 过 ， 有 具体 代码 如 下 : 


<Context :component-scan base-package="com.ay. controller "/> 


<context:component-scan /> 元 素 的 功能 是 ， 启 动 包 扫描 功能 ， 使 加 有 人 @Controller、 
@Service、@Respository、@Component 等 注解 的 类 能 够 成 为 Spring 的 bean。base-package 属性 
指定 了 需要 扫描 的 类 包 ， 类 包 及 其 包含 的 子 包 中 的 所 有 类 都 会 被 处 理 。 

此 外 ， 还 需要 在 web.xml 文件 中 配置 Spring MVC 的 前 端 控制 器 DispatcherServlet， 以 及 在 
spring-mvc.xml 配置 文件 中 配置 InternalResourceViewResolver 视图 解析 器 ， 有 具体 配置 在 第 2 章 已 
详细 介绍 ， 这 里 不 再 闭 述 。 

启动 项 目 springmvc-mybatis-book ， 在 浏览 器 中 输入 URL 路 径 : 
http://localhost:8080/user/hello， 会 看 到 如 图 6-1 所 示 的 图 片 ， 表 示 Spring MVC 访问 成 功 。 


[9 Getting Started: Servin x 
各 人 | © iocalhost8080puserAheik 
5 应 用 党 百度 兰 【 接 索 ] 兰 [CSDN] 兰 【技术 论坛 


hello, ay 


图 6-1 AyUserController 控制 层 成 功 访 问 界面 
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6.1.2 @RequestMapping 注解 


@RequestMapping 是 Spring Web 应 用 程序 中 最 常 被 用 到 的 注解 之 一 ， 这 个 注解 会 将 HTTP 
请 求 映 射 到 MVC 和 RES 控制 器 的 处 理 方法 上 。@RequestMapping 注解 可 以 在 控制 器 类 的 级 别 
或 方法 的 级 别 上 使 用 ， 在 类 级 别 上 的 注解 会 将 一 个 特定 请 求 或 者 请 求 模式 映射 到 一 个 控制 器 之 
上 ， 之 后 你 还 可 以 另外 添加 方法 级 别 的 注解 来 进一步 指定 到 处 理 方法 的 映射 关系 。 先 来 看 一 个 
有 具体 示例 ; 

@Controller 


@RequestMapping (value = "/user") 
public class AyUserController { 


@RequestMapping ("/hello") 
public String hello(Model model){ 
model.addAttribute ("message", "hello ay"); 
return "hello"; 
} 
上 述 代 码 中 ， 当 要 访问 AyUserController 类 中 的 hello 方法 时 ， 可 在 浏览 器 中 输入 如 下 的 请 
求 URL: 
http://localhost:8080/user/hello 
@RequestMapping 注解 除了 value 属性 外 ， 还 有 很 多 其 他 的 属性 ， 具 体 如 表 6-1 所 示 。 


表 6-1 @RequestMapping 常用 属性 


属性 名 称 | 类 型 是 否 必 填 | 描述 


value String[] 否 指定 请 求 的 实际 地 址 
name String 和 否 给 映射 地 址 指定 一 个 别名 
method RequestMethod[] | 否 指定 请 求 的 method 类 型 ,包括 GET、POST、PUT、DELETE 等 
, 指定 处 理 请 求 的 提交 内 容 类 型 (Content-Type )， 例 如 
consumer | String[] 和 否 和 
application/ json, text/html 
. 指定 返回 的 内 容 类 型 , 返回 的 内 容 类 型 必须 是 request 请 求 头 
produces | String[] 否 
中 的 〈Accept) 类 型 中 包含 该 指定 类 型 
params String[] 否 指定 request 中 必须 包含 某 些 参 数值 时 ， 才 能 让 该 方法 处 理 
有 String[] ee 指定 request 中 必须 包含 某 些 指定 的 header 值 时 ， 才 能 让 该 
9 ” 方法 处 理 请 求 
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我 们 来 看 几 个 实例 ， 具 体 代 码 如 下 : 


@Controller 
@RequestMapping (value = "/user") 
public class AyUserController { 


@QRequestMapping (value = { 
W M7 
"/page", 
"page*", 
"view/*,**/msg" 
}) 
public String hello(Model model) { 
model.addAttribute ("message", "hello ay"); 
return “helilo"; 


} 


如 上 代码 可 知 ， 可 以 将 多 个 请 求 映射 到 一 个 方法 上 ， 只 需要 添加 一 个 带 有 请 求 路 径 值 列 表 
的 @RequestMapping 注解 就 可 以 了 。 

在 浏览 器 中 访问 如 下 URL， 都 会 定位 到 hello 方法 上 : 

localhost:8080/user 

localhost:8080/user/ 

localhost:8080/user/page 

localhost:8080/user/pageabc 

localhost:8080/user/view/ 


localhost:8080/user/view/view 


Spring MVC 的 @RequestMapping 注解 能 够 处 理 HTTP 请 求 的 方法 ,比如 GET、PUT、POST、 
DELETE 以 及 PATCH, 所 有 的 请 求 默认 是 HTTP GET 类 型 的 。 为 了 将 一 个 请 求 映 射 到 一 个 特定 
的 HTTP 方法 上 ， 需 要 在 @RequestMapping 中 使 用 method 属性 来 声明 HTTP 请 求 所 使 用 的 方法 
类 型 ， 如 下 所 示 : 

@Controller 


@RequestMapping (value = "/user") 
public class AyUserController { 


@RequestMapping (method = RequestMethod.GET) 
String get () { 
return "Hello from get"; 


GE 
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QRequestMapping (method = RequestMethod.DELETE) 
String delete() { 

return "Hello from delete"; 
} 
QRequestMapping (method = RequestMethod.POST) 
Strung poOst() { 

return “Hello from post",; 
} 
QRequestMapping (method = RequestMethod.PUT) 
hor etavo ob la l() el 

return "Hello from put"; 
} 
GQRequestMapping (method = RequestMethod.PATCH) 
SrilngepoLen() 

return "Hello from patch,; 


} 


在 上 述 代码 中 ，@RequestMapping 注解 中 的 method 元 素 声明 了 HTTP 请 求 方法 的 类 型 。 所 
有 的 处 理 方法 会 处 理 同一 个 URL (/user) 进来 的 请 求 , 但 具体 要 看 指定 的 HTTP 方法 类 型 来 决 
定 用 哪个 方法 处 理 。 例 如 ， 一 个 POST 类 型 的 请 求 /user 会 交 给 post() 方 法 来 处 理 ， 而 一 个 
DELETE 类 型 的 请 求 /user 则 会 由 delete0 方 法 来 处 理 。 

可 以 使 用 @RequestMapping 注解 的 produces 和 consumes 属性 来 指定 处 理 请 求 的 提交 内 容 
类 型 〈Content-type) 和 返回 的 内 容 类 型 ， 返 回 的 类 型 必须 是 request 请 求 头 〈Accept) 中 所 包含 
的 类 型 。 有 具体 可 以 看 下 面 的 实例 : 


@Controller 
@RequestMapping (value = "/user") 
public class AyUserController { 


@RequestMapping(value = "/produces", produces = { 
"application/json" 

}) 

QResponseBody 

String getProduces() { 


return "Produces attribute"; 


@RequestMapping(value = "/consumes", consumes = { 


"application/json", 


习 使 
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"application/xml" 
}) 
String getConsumes() { 
return "Consumes attribute"; 


} 


上 述 代码 中 ，getProduces() 方 法 会 返回 JSON 类 型 的 响应 (application/json)，getConsumes() 
处 理 方法 可 以 同时 处 理 请 求 中 的 JSON 和 XML 内 容 。 

@RequestMapping 注解 提供 了 一 个 header 元 素来 根据 请 求 中 的 消息 头 内 容 缩 小 请 求 映射 的 
范围 。 该 属性 指定 request 中 必须 包含 某 些 指定 的 header 值 ， 才 能 让 该 方法 处 理 请 求 。 具 体 实 例 
如 下 : 


QController 
@RequestMapping (value = "/user") 
public class AyUserController { 


@RequestMapping (value = "/head", headers = { 
"content-type=text/plain" 
}) 
String Post() | 
return "Mapping applied along with headers"; 


} 


上 述 代码 中 ，@RequestMapping 注解 的 headers 属性 将 映射 范围 缩小 到 postO 方 法 。postO 
方法 只 会 处 理 /user/head 请 求 路 径 ， 并 且 content-type 被 指定 为 text/plain 的 请 求 。 当 然 ， 还 可 以 
指定 多 个 消息 头 。 具 体 代码 如 下 所 示 : 


@Controller 
@RequestMapping (value = "/user") 
public class AyUserController { 


@RequestMapping (value = "/head", headers = { 
"content-type=text/plain", 
"content-type=text/html" 

Siestavo el oo 全 二 直 

return "Mapping applied along with headers"; 
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上 述 代 码 中 ，post0 方 法 能 同时 接受 请 求 类 型 为 text/plain 和 text/html 的 请 求 。 

@RequestMapping 可 以 通过 params 属性 帮助 进一步 缩小 请 求 映射 的 定位 范围 。 使 用 params 
属性 ， 可 以 让 多 个 处 理 方法 处 理 同一 个 URL 的 请 求 ， 而 这 些 请 求 的 参数 是 不 一 样 的 。 可 以 用 
myParams = myValue 这 种 格式 来 定义 参数 ， 也 可 以 使 用 通配符 来 指定 特定 的 参数 值 在 请 求 中 是 
不 支持 的 。 有 具体 实例 代码 如 下 所 示 : 

@Controller 


@RequestMapping (value = "/user") 
public class AyUserController { 


@RequestMapping (value = "/fetch", params = { 
"personId=10" 


}) 
public String getParams (GRequestParam("personId") String id) { 


return “Fetched parameter using params attribute = " + id; 
} 
GRequestMapping(value = "/fetch", params = { 
"personId=20" 


}) 
public String getParamsDifferent (@RequestParam("personId") String iqd) { 


return "Fetched parameter using params attribute = " + id; 


上 述 代 码 中 ，getParams() 和 getParamsDifferent0 两 个 方法 都 能 处 理 相 同 的 一 个 URL 

Cuserfetch) ， 但 会 根据 params 属性 的 配置 不 同 而 决定 执行 哪 一 个 方法 。 例 如 ， 当 URL 是 /user 

/fetch?id=10, getParams() 方 法 会 执行 ， 因 为 id 的 值 为 10。 对 于 user/fetch?personId=20 请 求 URL， 
getParamsDifferent() 方 法 会 执行 ， 因 为 id 值 为 20。 


6.1.3”@GetMapping 和 @PostMapping 注解 


@GetMapping 是 一 个 组 合 注解 ， 是 @RequestMapping(method = RequestMethod.GET) 的 缩 
写 。 该 注解 将 HTTP GET 请 求 映 射 到 特定 的 处 理 方 法 上 。 类 似 的 @PostMapping 注解 是 
@RequestMapping(method = RequestMethod.POST) 的 缩写 。 @PutMapping 注解 是 
@RequestMapping(method = RequestMethod.PUT) 的 缩写 。 @DeleteMapping 注解 是 
@RequestMapping(method = RequestMethod.DELETE) 的 缩 写 。 @PatchMapping 注解 是 
@RequestMapping(method = RequestMethod.PATCH) 的 缩写 。 上 有 具 体 示例 代码 如 下 所 示 : 


本 不 。 
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@Controller 
@RequestMapping (value = "/user") 
public class AyUserController { 


@GetMapping ("/findById/{id}") 
public String findById(@PathVariable String id) { 
1 


Eerie 


} 


QPostMapping (path = "/add") 
public String add(@RequestBody AyUser ayUser) { 
YI 


return ""; 


} 


在 浏览 器 中 输入 请 求 URL: http://localhost:8080/user/findById/1 时 ， 请 求 中 的 id=1 会 将 值 赋 
给 findByld 方 法 中 的 id 变量 。 在 浏览 器 中 输入 URL: http://localhost:8080/user/add 时 ， 同 时 该 请 
求 为 POST 请 求 时 ， 会 调用 add 方法 添加 用 户 。 


6.1.4 Model 和 ModelMap 


Spring MVC 内 部 使 用 一 个 org.springframework.ui.Model 接口 存储 数据 模型 ， 它 的 功能 类 似 
于 java.uitl.Map。org.springframework.ui.ModelMap 实现 Map 接口 。Spring MVC 在 调用 方法 前 会 
创建 一 个 隐 含 的 数据 模型 ， 作 为 模型 数据 的 存储 容器 。 如 果 处 理 方法 入 参 为 Map 或 者 Model 类 
型 ，Spring MVC 会 将 隐 含 模型 的 引用 传递 给 Map 或 者 Model， 这 样 就 可 以 在 Map 或 者 Model 
模型 中 访问 所 有 的 数据 ， 可 以 向 模型 中 添加 新 的 属性 数据 。 有 具体 实例 如 下 所 示 : 

@Controller 


@RequestMapping ("/user") 
public class AyUserController { 


@ModelAttribute 

public void redirectTest (Model model)t 
model.addAttribute ("name","ay"™); 

} 


@RequestMapping ("hello") 
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public String hello(Model model, ModelMap modelMap, Map map) { 


return "hello"; 


} 


在 浏览 器 中 输入 请 求 URL: http://localhost:8080/user/hello 时 ， 由 于 redirectTest 方法 添加 
@ModelAttribute 注解 ， 故 redirectTest 方法 优先 执行 。 在 redirectTest 方法 中 设置 name 属性 的 值 
为 “ay”， 在 hello 方 法 中 Model、ModelMap 和 Map map 对 象 都 可 以 获取 到 该 name 的 属性 值 。 
虽然 redirectTest 方法 (Model model, ModelMap modelMap, Map map) 定义 了 三 个 不 同 的 类 型 参 


数 ， 但 三 者 是 同一 个 对 象 。 


6.1.5 ModelAndView 


当 控 制 器 处 理 完 请 求 时 ， 通 常会 将 包含 视图 信息 和 模型 数据 信息 的 ModelAndView 对 象 返 


回 ， 这 样 Spring MVC 将 使 用 包含 的 视图 对 模型 数据 进行 渲染 。 具 体 实例 如 下 所 示 : 


@Controller 
@RequestMapping("/user") 
public class AyUserController { 


@RequestMapping ("hello") 

public ModelAndView hello(){ 
ModelAndView mv = new ModelAndView(); 
mv.addObject ("name", "ay"); 
mv.setViewName ("hello"); 


return mv; 


有 


在 处 理 方法 中 可 以 使 用 ModelAndView 对 象 的 addObject 方法 添加 属性 和 值 ， 
setViewName 方法 设置 视图 名 称 。 上 述 代码 等 价 于 : 


QController 
@RequestMapping("/user") 
public class AyUserController { 


QRequestMapping ("hello") 

public String hello(Model model)f{ 
model.addAttribute ("name", "ayn) ， 
KREEUERD Nellou, 
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6.1.6 ”请求 方 法 可 出 现 参数 和 可 返回 类 型 
请 求 方法 可 出 现 的 参数 中 ， 除 了 Model 和 ModelMap 对 象 外 ， 还 可 以 出 现 其 他 的 对 象 。 具 
体内 容 如 表 6-2 所 示 。 
表 6-2 请求 方 法 可 出 现 的 参数 

属性 名 称 描 述 

ServletRequest 

ServletResponse 请 求 或 响应 对 象 〔Serviet API) 

HttpServletRequest 

HttpServletResponse 

HttpSession HttpSession 类 型 的 会 话 对 象 〈Servlet API) 


java.util.Locale 


当前 请 求 的 地 区 信息 java.util.Locale， 由 已 配置 的 最 相关 的 地 区 解析 
器 解析 得 到 。 在 MVC 的 环境 下 ， 就 是 应 用 中 配置 的 LocaleResolver 


或 LocaleContextResolver 


Java.util.TimeZone 


与 当前 请 求 绑 定 的 时 区 信息 java.util.TimeZone (java 6 以 上 的 版 本 ) 
/java.time.Zoneld (java 8)， 由 LocaleContextResolver 解析 得 到 


org.springframework. 


获取 HTTP 请 求 方法 
http.HttpMethod wi 
java.security.Principal 包装 了 当前 被 认证 用 户 信息 


HttpEntity<?> 


提供 了 对 HTTP 请 求 头 和 请 求 内 容 的 存 取 。 
HttpMessageConverter 被 转换 成 entity 对 象 的 


请 求 流 是 通过 


org.springframework.web.servlet. 


myvc.support.RedirectAttributes 


用 以 指定 重 定向 下 要 使 用 到 的 属性 集 以 及 添加 flash 属性 〈 暂 存在 服 
务 端的 属性 ， 它 们 会 在 下 次 重 定向 请 求 的 范围 中 有 效 ) 


org.springframework. 
validation.Errors 

或 org.springframework. 
validation.BindingResult 


验证 结果 对 象 ， 用 于 存储 前 面 的 命令 或 表单 对 象 的 验证 结果 〈 紧 接 其 
前 的 第 一 个 方法 参数 ) 


org.springframework. 
web.bind.support.SessionStatus 


用 以 标记 当前 的 表单 处 理 已 结束 ， 这 将 触发 一 些 清理 操作 : 


@SessionAttributes 在 类 级 别 标注 的 属性 将 被 移 除 


org.springframework.web 


.util.UriComponentsBuilder 


下 面 来 看 几 个 具体 实例 。 


用 于 构造 当前 请 求 URL 相关 的 信息 ， 比 如 主机 名 、 端 口号 、 资 源 类 型 
(scheme)、 上 下 文 路 径 、servlet 映射 中 的 相对 部 分 (literal part) 等 


如 果 需 要 访问 HttpServletRequest 对 象 ， 可 以 将 其 添加 到 方法 中 作为 参数 ，Spring 会 将 对 象 


正确 的 传递 方法 。 


仅 供 非 商业 用 途 或 交流 学 习 使 用 


j 途 或 交流 学 习 使 


非 卖 品 ， 仅 供 非 商业 用 途 或 交流 学 习 使 


124 | Spring MVC + MyBatis 快速 开发 与 项 目 实战 


@RequestMapping ("hello") 

public ModelAndView hello(HttpServletRequest request){ 
ModelAndView mv = new ModelAndView (); 
mv,addObject (人 name ay); 
mv.setViewName ("hello"); 
return mv; 


} 


如 果 需 要 访问 HttpMethod 对 象 ， 可 以 将 其 添加 到 方法 中 作为 参数 ，Spring 会 将 对 象 正确 的 
传递 方法 。 
@RequestMapping ("hello") 
public ModelAndView hello(HttpMethod method){ 
ModelAndView mv = new ModelAndView(); 
mv.addObject ("name", "ay"); 
mv.setViewName ("hello"); 


return mv; 


} 


请 求 方法 可 返回 的 参数 中 ， 除 了 ModelAndView 对 象 外 ， 还 可 以 出 现 其 他 的 对 象 。 下 面 列 
举 几 个 常用 的 返回 值 ， 具 体内 容 如 表 6-3 所 示 。 


表 6-3 请求 方法 可 返回 的 参数 


属性 名 称 描 述 
Model、ModelMap、Map 模型 对 象 


返回 值 为 String 类 型 ， 有 三 种 用 处 : 

(1) 表示 返回 逻辑 视图 名 。 
真正 视图 (JSP 路径 ) = 前 级 + 逻辑 视图 名 + 后 级， 例如 : 
return "index" 

(2) redirect 重 定向 
redirect 重 定向 特点 : 浏览 器 地 址 栏 中 的 URL 会 变化 。 修 改 提交 的 
String request 数据 无 法 传 到 重 定向 的 地 址 。 因 为 重 定向 后 需 重新 进行 
request (request 无 法 共享 ) 例如 : 
return "redirect:xxx.action"” 重 定向 到 男 一 个 Action 请 求 中 

(3) forward 页 面 转发 
通过 forward 进行 页 面 转发 ， 浏 览 器 地 址 栏 URL 不 变 ，request 可 
以 共享 。 


return "forward:xxx.action" 
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( 续 表 ) 

属性 名 称 描述 
如 果 处 理 器 方法 中 已 经 对 response 响应 数据 进行 了 处 理 ( 比 如 在 方 
void 法 参数 中 定义 一 个 ServletResponse 或 HttpServletResponse 类 型 的 参 


数 并 直接 向 其 响应 体 中 写 东 西 )， 那 么 方法 可 以 返回 void 


HttpEntity<?> 或 ResponseEntity<?> 


提供 对 Servlet HTTP 响应 头 和 响应 内 容 的 存储 ， 对 象 会 被 
HttpMessageConverters 转换 成 响应 流 


6.2 ”参数 绑 定 注 解 


6.2.1 @RequstParam 注解 


@RequstParam 注解 用 于 将 制定 的 请 求 参数 赋值 给 方法 中 的 形 参 。@RequstParam 注解 可 以 


使 用 的 属性 如 表 6-4 所 示 。 
表 6-4 @RequstParam 常用 属性 
属性 名 称 类 “型 是 否 必 填 描 述 
name String 否 指定 请 求 头 绑 定 的 名 称 
value String 否 name 属性 的 别名 
required Boolean 人 盏 指定 参数 是 否 必须 绑 定 
defaultValue String 否 请 求 没有 传递 参数 而 使 用 的 默认 值 


@RequstParam 注解 的 使 用 实例 如 下 : 


@Controller 
@RequestMapping (value 


六 vv/user™) 


public class AyUserController { 


QRequestMapping ("findById") 
public String findById (@RequestParam(value="id") String id)t 


} 


AyUser ayUser 


ayUserService.findByld (id); 


return "success"; 


当 浏 览 器 中 输入 URL 请 求 http://localhost:8080/user/findById?id=1 时 ， 请 求 中 的 id=1 会 将 值 
赋 给 findByld 方法 中 的 id 变量 。@RequstParam 注解 可 以 使 用 required 属性 指定 参数 是 否 必须 传 
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值 。 如 果 参 数 没有 接收 到 任何 值 ， 可 以 使 用 defaultValue 指定 参数 的 默认 值 。 具 体 代 码 如 下 


@Controller 
@RequestMapping (value = "/user") 
public class AyUserController { 


@RequestMapping("/findByNameAndPassword") 
public String findByNameAndPassword( 
@RequestParam(value="name") String name, 
QRequestParam (value="password",required = false, 
defaultValue = "123") String password){ 
System.out.println ("name=" + name); 
System.out.println ("password" + password); 


return "success"; 


} 
当 浏 览 器 中 输入 URL 请 求 : http://localhost:8080/user/findByNameAndPassword?name=ay 


时 ，name 参数 被 赋值 为 ay， 由 于 password 没 传 任何 值 ， 故 默认 值 为 123。 


6.2.2”@PathVariable 注解 


@PathVariable 注解 可 以 将 URL 中 动态 参数 绑 定 到 控制 器 处 理 方法 的 入 参 中 。 


@PathVariable 注解 只 有 一 个 value 属性 ， 类 型 为 String， 表 示 绑 定 的 名 称 ， 如 果 缺 省 则 默认 绑 定 
同名 参数 。 具 体 示例 如 下 所 示 : 


@Controller 
@RequestMapping (value = "/user") 
public class AyUserController { 


@RequestMapping("/owners/{ownerId}/pets/{petId}") 
public String findPet (@PathVariable Long ownerId, @PathVariable 
Long petId) { 

Md ee 
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当 在 浏览 器 中 输入 请 求 URL: http://localhost:8080/user/owners/123/pets/456 时 ， 则 自动 将 动 
态 参 数 {ownerId} 和 {petId} 的 值 123 和 456 绑 定 到 @PathVariable 注 解 的 同名 参数 上 ， 即 ownerld = 


123，petId = 456。 


URL 中 的 动态 参数 除了 可 以 绑 定 到 方法 上 ， 还 可 以 绑 定 到 类 上 ， 上 有 具体 示 例如 下 所 示 : 


@Controller 
@RequestMapping (value = 


public class AyUserController { 


"/owners/ {ownerId}") 


@RequestMapping("/pets/{petId}") 
public String findPet (GPathVariable Long ownerlId, @PathVariable 
Long PetIQ) { 


} 


returne 


当 在 浏览 器 中 输入 请 求 URL: http://localhost:8080/owners/123/pets/456 时 ， 则 自动 将 类 上 的 
动态 参数 {ownerId} 和 方法 上 的 动态 参数 {petId} 的 值 绑 定 到 @PathVariable 注解 的 同名 参数 上 ， 
即 ownerId = 123, petld= 456。 


6.2.3”@RequestHeader 注解 


@RequestHeader 注解 可 以 将 请 求 的 头 信 息 数 据 映 射 到 处 理 的 方法 参数 上 ，@RequestHeader 


注解 的 属性 如 表 6-5 所 示 。 
表 6-5 @RequestHeader 常用 属性 
属性 名 称 类 型 是 否 必 填 | 
name String 否 指定 请 求 头 绑 定 的 名 称 
value String 否 name 属性 的 别名 
required Boolean 否 指定 参数 是 否 必须 绑 定 
defaultValue String 否 请 求 没 有 传递 参数 而 使 用 的 默认 值 


一 般 请 求 头 信息 如 下 所 示 : 


Host 

Accept 
Accept-Language 
Accept-Encoding 


localhost:8080 


text/html,application/xhtml+xml,application/xml;q=0.9 


fr,en-gb;q=0.7,en;q=0.3 


gzip,deflate 


仅 供 非 商 业 


途 或 交流 学 习 使 
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Accept Charset ISQ=8859 -17 utf 09 0 /T7907 

Keep-Alive 300 

下 面 通过 @RequestHeader 注解 获取 Accept-Encoding 和 Keep-Alive 信息 ， 有 具体 示 例如 下 
所 示 : 

@Controller 


@RequestMapping (value = "/user") 
public class AyUserController { 


@RequestMapping ("/requestHeader") 
public String handlel( 
@RequestHeader ("Accept-Encoding") String[] encoding, 
@RequestHeader ("Accept") String[] accept) { 
We 
Selb tS onto. 
} 
} 

当 在 浏览 器 中 输入 请 求 URL: http://localhost:8080/user/requestHeader 时 ， 则 自动 将 请 求 头 
“Accept-Encoding ”和 “Accept ”的 值 赋 到 encoding 和 accept 变量 上 ， 由 于 请 求 头 
“Accept-Encoding” 和 “Accept” 的 数据 类 型 是 数组 ， 所 有 定义 encoding 和 accept 变量 为 

String[] 类 型 。 


6.2.4”@CookieValue 注解 


@CookieValue 注解 用 于 将 请 求 的 Cookie 信息 映射 到 处 理 的 方法 参数 上 ，@CookieValue 注 
解 的 属性 如 表 6-6 所 示 。 


表 6-6 @CookieValue 常用 属性 


属性 名 称 类 型 是 否 必 填 描述 

name String | 否 指定 请 求 头 绑 定 的 名 称 
value | String | 否 | name 属性 的 别名 
id | Boolean | 香 | 指定 参数 是 否 必须 绑 定 


defaultValue String 请 求 没有 传递 参数 而 使 用 的 默认 值 


@CookieValue 注解 如 何 使 用 ， 具 体 示 例如 下 所 示 : 
@Controller 
QRequestMapping (value = "/user") 


public class AyUserController { 


仅 供 非 商 业 用 途 或 交流 学 习 使 / 
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@RequestMapping("/cookieValue") 
public String handle(@CookieValue ("JSESSIONID") String Cookie) { 
He 


Feturn 


} 


当 在 浏览 器 中 输入 请 求 URL : http://localhost:8080/user/cookieValue 时 ， 则 自动 将 
JSESSIONID 值 设 置 到 Cookie 参数 上 。 


6.2.5”@ModelAttribute 注解 


@ModelAttribute 注解 主要 是 将 请 求 参数 绑 定 到 Model 对 象 上 。@ModelAttribute 注解 只 有 
一 个 value 属性 ， 类 型 为 String， 表 示 绑 定 的 属性 名 称 。 当 Controller 类 中 有 任意 一 个 方法 被 
@ModelAttribute 注解 标记 ， 页 面 请 求 只 要 进入 这 个 控制 器 ， 不 管 请 求 那个 方法 ， 均 会 先 执行 
@ModelAttribute 标记 的 方法 ， 所 以 可 以 用 @ModelAttribute 注解 的 方法 做 一 些 初始 化 操作 。 当 
同一 个 Controller 类 中 有 多 个 方法 被 @ModelAttribute 注解 标记 ， 所 有 被 @ModelAttribute 标记 的 
方法 均 会 被 执行 ， 按 先后 顺序 执行 ， 然 后 再 进入 请 求 的 方法 。 具 体 实例 代码 如 下 所 示 : 


@Controller 
@RequestMapping (value = "/user'") 
public class AyUserController { 


@ModelaAttribute 
bublrie vond Tint() 
SYySEemsoute pr lintlrn (nt 信 2 


@ModelAttribute 
publio vold TnrtO2()t 
svstem.out.printlin ("init 02 .2) 1， 


@GetMapping ("/findById/{id}") 
public String findByld(@PathVariable String id) { 
Me 


TetULNY Vn; 


@ModelAttribute 
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DuUplie volideInitOs() 1 
SYSCem ou rineln (init 03) 
} 
} 
当 在 浏览 器 输入 访问 URL: http://localhost:8080/user/findById/1 时 ， 便 可 以 在 控制 台 看 到 打 
印信 息 : 
i 
et 0 2 
Tmie 0 


@ModelAttribute 注解 有 很 多 的 额外 使 用 方式 ， 下 面 逐 一 进行 介绍 。 
1. @ModelAtterbute 方 法 无 返回 值 的 情况 


@Controller 
@RequestMapping (value = "/user") 
public class AyUserController { 


@ModelAttribute 

public void init(Model model){ 
AyUser ayUser = new AyUser () ， 
ayUser.setId(1); 
ayUser.setName ("ay"); 
model.addaAttribute ("user", ayUser); 


@GetMapping("/hello") 
pubElem ir ed lo 
return "hellon; 


} 
上 述 代 码 中 @ModelAttribute 注解 标记 的 init 方法 无 任何 返回 值 ， 在 init 方法 中 创建 一 个 用 


户 对 象 AyUser 并 设置 id 和 name 的 值 ， 最 后 调用 Model 对 象 的 addAttribute 方法 设置 到 Model 
对 象 中 。 对 应 前 端 src\main\webapp\WEB-INF\views\hello.jsp 页 面 代 码 如 下 所 示 : 


<%Qpage language="java" contentType="text/html; charset=UTF-8" 
pageEncoding="UTF-8" isELIignored="false"%> 

<!DOCTYPE HTML> 

<html> 

<head> 
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<title>Getting Started: Serving Web Content</title> 
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8" /> 
</head> 
<body> 
hello, ${user.name} 
</body> 
</html> 


当 在 浏览 器 中 输入 请 求 URL: http://localhost:8080/user/hello 时 ， 浏 览 器 显示 “hello，ay”。 

从 执行 结果 可 以 看 出 ， 当 执行 请 求 时 ， 首 先 访问 init 方法 ， 然 后 再 访问 hello 方法 ， 并 且 是 
同一 个 请 求 。 因 为 model 模型 数据 的 作用 域 与 request 相同 ， 所 以 可 以 用 @ModelAttribute 注解 直 
接 标记 在 方法 上 对 实际 要 访问 的 方法 进行 一 些 初始 化 操作 。 


2. @ModelAttribute 标 记 方 法 有 返回 值 


@Controller 
@RequestMapping (value = "/user") 
public class AyUserController { 


QModelAttribute ("name") 
public String init (GRequestParam(value = "name", required = false) String 
name)t{ 


return name; 


@GetMapping("/hello") 
publlies String Dello() 
return "hello"; 


} 


上 述 代码 中 ，@ModelAttribute 注解 标注 的 init 方法 带 有 返回 值 ，@ModelAttribute("name") 
的 value 属性 值 为 key， 而 init 方 法 值 为 value， 类 似 于 : 


model.addAttribute ("name",name); 


对 应 前 端 src\main\webapp\WEB-INF\views\hello.jsp 页 面 代码 如 下 所 示 : 


<sQ@page language="java" contentType="text/html; charset=UTF-8" 
pageEncoding="UTF-8" isELIignored="false"%> 

<!IDOCTYPE HTML> 

<html> 

<head> 
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<title>Getting Started: Serving Web Content</title> 
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8" /> 
</head> 
<body> 
hello, ${name} 
</body> 
</html> 


当 在 浏览 器 中 输入 请 求 URL: http://localhost:8080/user/hello 时 ， 浏 览 器 显示 “hello，ay”。 
3. @ModelAttribute 注 解 和 @RequestMapping 注 解 


@ModelAttribute 注解 和 @RequestMapping 注解 同时 标记 在 一 个 方法 上 。 


@Controller 
public class AyUserController { 


@ModelAttribute ("name") 
@RequestMapping (value = "/hello") 
public String hello(){ 


return ay; 


} 


上 述 代码 中 ，@ModelAttribute 注解 和 @RequestMapping 注解 同时 标记 在 hello 方法 上 ， 同 

时 我 们 把 AyUserController 类 上 的 @RequestMapping 注解 去 掉 。 此 时 ，hello 方法 的 返回 值 

“ay” 并 不 是 视图 名 称 ， 而 是 model 属性 的 值 ， 视 图 名 称 是 @RequestMapping 的 value 值 

“hello”。Model 的 属性 名 称 由 @ModelAttribute 的 value 值 指定 ， 相 当 于 在 request 中 封装 了 name 
(key) =ay (value) 。 对 应 前 端 src\main\webapp\WEB-INF\views\hello.jsp 页 面 代码 如 下 所 示 : 


<%Qpage language="java" contentType="text/html; charset=UTF-8" 
pageEncoding="UTF-8" isELIgnored="false"%®> 
<!DOCTYPE HTML> 
<html> 
<head> 
<title>Getting Started: Serving Web Content</title> 
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8" /> 
</head> 
<body> 
hello, $ {name} 
</body> 
</htmi> 


当 在 浏览 器 中 输入 请 求 URL: http://localhost:8080/hello 时 ， 浏 览 器 显示 “hello，ay”。 
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4. 使 用 @ModelAttribute 注 解 方法 的 参数 。 


@Controller 


@RequestMapping("/user") 


public class AyUserController { 


QModelAttribute ("ayUser") 
public AyUser init(@RequestParam("id") Integer id, 


AyUser 


ayUser. 
BYXUSenme 


return 


} 


@RequestParam("name") String name)f{ 
ayUser = new AyUser (); 
setIid(id); 
setName (name) : 


ayUser; 


@RequestMapping (value="hello") 
public String hello(@ModelAttribute ("ayUser") AyUser ayUser){ 


return 


} 


"nello"™; 
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当 在 浏览 器 中 输入 请 求 URL: http://localhost:8080/user/hello?id=1&name=ay 时 ， 会 优先 执 
行 init 方 法 ， 把 id 和 name 的 值 赋值 给 init 方 法 绑 定 的 参数 ， 同 时 构造 AyUser 对 象 返 回 。 这 里 
model 的 属性 名 称 就 是 @ModelAttribute("ayUser") 的 value 值 “ayUser”，model 的 属性 值 就 是 
init 方法 的 返回 值 。hello 方法 的 参数 AyUser 使 用 了 注解 @ModelAttribute("ayUser")， 表 示人 参数 
ayUser 的 值 就 是 init 方法 中 的 model 属性 。 

对 应 前 端 src\main\Wwebapp\WEB-INF\views\hello.jsp 页 面 代码 如 下 所 示 : 


<%@page language="java" contentType="text/html; charset=UTF-8" 


pageEncoding="UTF-8" isELIgnored="false"%> 
<!IDOCTYPE HTML> 


<html> 
<head> 


<title>Getting Started: Serving Web Content</title> 
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8" /> 


</head> 
<body> 


hello, ${ayUser.name} 


</body> 
</html> 
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6.2.6 @SessionAttribute 和 @SessionAttributes 注解 


@ModelAttribute 注解 作用 在 方法 或 者 方法 的 参数 上 ， 表 示 将 被 注解 的 方法 的 返回 值 或 者 
是 被 注解 的 参数 作为 Model 的 属性 加 入 到 Model 中 ，Spring 框架 会 将 Model 传递 给 前 端 。Model 
的 生命 周期 只 存在 于 HTTP 请 求 的 处 理 过 程 中 ， 请 求 处 理 完 成 后 ，Model 就 销毁 了 。 如 果 想 让 
参数 在 多 个 请 求 间 共享 ， 那 么 需要 用 到 @SessionAttributes 注解 。@SessionAttributes 注解 只 能 声 
明 在 类 上 ， 不 能 声明 在 方法 上 。 

@SessionAttributes 注解 常用 的 属性 如 表 6-7 所 示 。 


表 6-7 @RequestHeader 常用 属性 


属性 名 称 | 类 型 | 是 否 必 填 | 描 述 

names String[] 否 需要 存储 到 session 中 数据 的 名 称 

value String 否 name 属性 的 别名 

types Class<?>[] | 否 根据 指定 参数 的 类 型 ， 将 模型 中 对 应 类 型 的 参数 存储 到 session 中 
下 面 看 具体 实例 ， 有 具体 代码 如 下 : 
@Controller 


@SessionAttributes ("ayUser") 
@RequestMapping ("/user") 
public class AyUserController { 


@RequestMapping ("redirect") 

public String redirectTest (Model model)f{ 
AyUser ayUser = new AyUser(); 
ayUser.setName ("ay"); 
model.addAttribute ("ayUser",ayUser); 
return “redirect:hello"; 


@RequestMapping ("hello") 

public String hello(ModelMap mode1LMap) { 
AyUser ayUser = (AyUser) modelMap.get ("ayUser"); 
System.out.printin (ayUser.getName ()); 
return ‘hello"; 
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在 浏览 器 中 输入 请 求 URL: http://localhost:8080/user/redirect 时 ， 由 于 AyUserController 类 
上 添加 注解 @SessionAttributes("ayUser")， 方 法 redirectTest 在 执行 过 程 中 ， 将 AyUser 对 象 存放 
到 Model 对 象 的 同时 ， 也 会 把 对 象 存 放 到 HttpSession 作用 域 中 。redirectTest 方法 执行 完成 之 
后 ， 会 重 定向 到 hello 方法 。 在 hello 方法 中 ，HttpSession 对 象 会 将 @SessionAttributes 注解 的 属 
性 写 入 到 新 的 Model 中 ， 所 以 可 以 通过 ModelMap 获取 的 AyUser 对 象 打印 信息 。 

除了 使 用 ModelMap 来 接收 HttpSession 对 象 中 的 值 外 ， 还 可 以 使 用 @SessionAttribute 注 
解 ， 具 体 实例 如 下 所 示 : 


@Controller 

@SessionAttributes ("ayUser") 
QRequestMapping ("/user") 

public class AyUserController { 


@RequestMapping ("redirect") 

public String redirectTest (Model model){ 
AyUser ayUser = new AyUser(); 
ayUser.setName ("ay"); 
model.addAttribute ("ayUser",ayUser); 
return "redirect:hello"; 


@RequestMapping ("hello") 

public String hellol(@SessionAttribute AyUser ayUser) { 
System.out .println(ayUser.getName ()); 
return "hello"™;? 


) 


上 述 代码 中 ， 在 hello 方 法 中 使 用 @SessionAttribute 注解 来 获取 @SessionAttributes("ayUser") 
注解 中 的 “ayUser” 对 象 并 赋值 给 AyUser 对 象 ， 这 样 就 可 以 很 方便 地 在 hello 方法 中 使 用 
AyUser 对 象 。 

如 果 想 删除 HttpSession 对 象 中 共享 的 属性 ， 可 以 通过 SessionStatus.setComplete()， 这 人 句 只 
会 删除 通过 @SessionAttribute 保存 到 HttpSession 中 的 属性 。 具 体 实例 如 下 所 示 : 


@RequestMapping ("redirect") 

public String redirectTest (Model model,SessionStatus sessionStatus){ 
AyUser ayUser = new AyUser (); 
ayUser.setName ("ay"); 
model.addAttribute ("ayUser",ayUser); 
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// 删 除 HttpSsession 中 的 属性 
sessionStatus.setComplete(); 


return "redirect:hello"™; 


} 
还 可 以 设置 多 个 对 象 到 HttpSession 中 ， 具 体 代码 如 下 : 


@SessionAttributes (types = {AyUser.class, AyRole.class},value = {"ayUser", 
a RO lew).) 


type 属性 用 来 指定 放 入 HttpSession 当中 的 对 象 类 型 。 


6.2.7 @ResponseBody 和 @RequestBody 注解 
1. @ResponseBody 注 解 


@ResponseBody 注解 用 于 将 Controller 方法 返回 的 对 象 ， 通 过 HttpMessageConverter 转换 为 
指定 格式 后 ， 写 入 到 Response 对 象 的 body 数据 区 。@Responsebody 注解 将 方法 的 返回 结果 直接 
写 入 HTTP 响应 正文 (ResponseBody) 中 ， 一 般 在 异步 获取 数据 时 使 用 。 在 使 用 @RequestMapping 
注解 时 ， 返 回 值 通常 被 解析 为 跳 转 路 径 ， 在 加 上 @Responsebody 后 返回 结果 就 不 会 被 解析 为 跳 转 
路 径 ， 而 是 直接 写 入 到 HTTP 响应 正文 中 。 

使 用 @ResponseBody 和 @RequestBody 注解 之 前 ， 需 要 在 pom.xml 文件 中 引入 Jackson 相关 
的 依赖 包 ， 具 体 示例 代码 如 下 : 


<dependency> 
<grouplId>com.fasterxml .jackson.core</groupId> 
<artifactId>jackson-core</artifactId> 
<version>2.9.5</version> 

</dependency> 

<dependency> 
<groupId>com.fasterxml .jackson.core</groupId> 
<artifactlId>jackson-annotations</artifactId> 
<version>2.9.5</version> 

</dependency> 

<dependency> 
<groupId>com.fasterxml .jackson.core</groupId> 
<artifactId>jackson-databind</artifactId> 
<version>2.9.5</version> 

</dependency> 
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Spring MVC 主要 是 利用 类 型 转换 器 messageConverters 将 前 台 信息 转换 为 开发 者 需要 的 格 
式 。 然 后 在 相应 的 Controller 方法 接受 参数 前 添加 @RequestBody 注解 ， 进 行 数据 转换 ， 或 者 在 
方法 的 返回 值 类 型 处 添加 @ResponseBody 注解 ， 将 返回 信息 转换 成 相关 格式 的 数据 。 

下 面 看 具体 实例 ， 代 码 如 下 所 示 : 


(1) 返回 普通 的 字符 串 


@Controller 
@RequestMapping ("/user") 
public class AyUserController { 


@RequestMapping ("/hello") 
@ResponseBody 
public String hello(){ 


return "I am not view"; 


} 


在 浏览 器 中 输入 访问 路 径 : http://localhost:8080/user/hello， 方 法 返回 的 不 是 视图 ， 而 是 把 
字符 串 “I am not view” 直 接 写 入 HTTP 响应 正文 中 ， 返 回 给 浏览 器 。 


(2) 返回 集合 对 象 


QController 
@RequestMapping ("/user") 
public class AyUserController { 


@RequestMapping ("/hello") 
@ResponseBody 
public List<String> hello()l! 
List<String> list = new ArrayList<String>(); 
list aaa(7ay7) 7 
list.add (aL) 
return list; 


} 


在 浏览 器 输入 访问 路 径 : http://localhost:8080/user/hello， 方 法 返回 的 不 是 视图 ， 而 是 把 
JSON 字符 串 “ {rhame™"ay"rage""3 中 ” 直接 写 入 HTTP 响应 正文 中 ， 返 回 给 浏览 器 。 


| 
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2. @RequestBody 注 解 


@RequestBody 注解 用 于 读 取 Request 请 求 的 body 部 分 数据 ， 使 用 系统 默认 配置 的 
HttpMessageConverter 进行 解析 ， 然 后 把 相应 的 数据 绑 定 到 Controller 方法 的 参数 上 。 
下 面 看 具体 实例 : 


@Controller 
@RequestMapping ("/user") 
public class AyUserController { 


@RequestMapping ("/hello") 

@ResponseBody 

public void hello(@RequestBody AyUser ayUser){ 
System.out .println("name" + ayUser.getName()); 


System.out .Println("password" + ayUser.getPassword()); 


6.3 ”信息 转换 详解 


6.3.1 HttpMessageConverter<T> 


在 Spring MVC 中 ，HttpMessageConverter 接 口 扮演 着 重要 的 角色 。Spring MVC 可 以 接收 不 
同 的 消息 格式 ， 也 可 以 将 不 同 的 消息 格式 响应 回去 (最 常见 的 是 JSON)〉。 这 些 消息 所 蕴含 的 
“有 效 信息 ”是 一 致 的 ， 那 么 各 种 不 同 的 消息 转换 器 ， 都 会 生成 同样 的 转换 结果 。 至 于 各 种 消 
居间 解析 细节 的 不 同 ， 就 被 屏蔽 在 不 同 的 HttpMessageConverter 实现 类 中 了 。HttpMessageConverter 
接口 类 具体 的 源码 如 下 所 示 : 


public interface HttpMessageConverter<T> { 
boolean canRead(Class<?> clazz, @Nullable MediaType mediaType); 
boolean canWrite(Class<?> clazz, @Nullable MediaType mediaType); 
List<MediaType> getSupportedMediaTypes () ; 


T read(Class<? extends T> clazz, HttpInputMessage inputMessage) 
throws IOException, HttpMessageNotReadableException; 


仅 供 非 商业 用 途 或 交流 学 习 使 用 LD 


非 卖 品 ， 仅 供 非 商 业 用 途 或 交流 学 习 使 
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void write(T t, @Nullable MediaType contentType, 
HttpOutputMessage outputMessage) throws IOException, 
HttpMessageNotWritableException; 


e canRead(Class<?> clazz, @Nullable MediaType mediaType): 指定 转换 器 可 以 读 取 
的 对 象 类 型 ， 同 时 指定 支持 MIME 类 型 (text/xml、application/json ) 。 

e canWrite(Class<?> clazz，@Nullable MediaType mediaType): 指定 转换 器 可 以 将 
clazz 类 型 的 对 象 写 到 响应 流 中 ， 响 应 流 支 持 类 型 在 mediaType 中 定义 。 

e getSupportedMediaTypes(): 该 转换 器 支持 的 媒体 类 型 。 

® Tread(Class<? Extends T> clazz, HttplnputMessage inputMessage): 将 请 求 信息 流 
转换 成 T 类 型 的 对 象 。 

e write(Tt @Nullable MediaType contentType, HttpOutputMessage outputMessage): 
将 T 类 型 的 对 象 写 到 响应 流 中 ， 同 时 指定 响应 媒体 类 型 为 contentType。 


Spring MVC 为 HttpMessageConverter 接口 提供 了 很 多 实现 类 ， 下 面 简单 列举 几 个 实现 类 的 
内 容 和 作用 ， 有 具体 如 表 6-8 所 示 。 


表 6-8 HttpMessageConverter 接口 实现 类 


属性 名 称 描 述 
将 请 求 信息 转换 为 字符 串 ， 泛 型 T 为 String， 可 读 取 所 有 媒体 
StringHttpMessageConverter 类 型 (*/*)， 可 通过 supportedMediaTypes 属性 指定 媒体 类 型 。 


响应 信息 的 媒体 类 型 为 text/plain 〈 即 Content-Type 的 值 ) 

读 写 二 进 制 数据 ， 泛 型 T 为 byte[] 类 型 ， 可 读 取 */*， 可 通过 
ByteArrayHttpMessageConverter supportedMediaTypes 属性 指定 媒体 类 型 ， 响 应 信息 媒体 类 型 
为 application/octer-stream 


泛 型 了 为 Object， 可 读 取 text/xml 和 application/xml 媒体 类 型 


MarshallingHttpMessageConverter 6 
arshallingHttp g 请 求 ， 响 应 信息 的 媒体 类 型 为 text/xml 或 application/xml 


通过 JAXB2 读 写 XML 信息 ， 将 请 求 消息 转换 到 标注 
XmlRootElement 和 XmlType 注解 的 类 中 ， 泛 型 工 为 Object， 
可 读 取 text/xml 和 application/xml 媒体 类 型 请 求 ， 响 应 信息 的 
媒体 类 型 为 text/xml 或 application/xml 


Jaxb2RootElementHttpMessageConverter 


利用 jackson 的 ObjectMapper 读 写 JSON 数据 ， 泛 型 T 为 
MappingJacksonHttpMessageConverter Object ， 可 读 取 application/json ， 响 应 媒体 类 型 为 


application/json 
表单 与 MultiValueMap 的 相互 转换 。 读 支持 响应 MediaType 
FormHttpMessageConverter 为 application/x-www-form-urlencoded， 写 支持 的 响应 类 型 为 


application/x-www-form-urlencoded 和 multipart/form-data 


仅 供 非 商业 用 途 或 交流 学 习 使 用 LD 
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属性 名 称 描 述 
数据 与 javax.xml.transform.Source 的 相互 转换 。 读 支持 响应 
SourceHttpMessageConverter MediaType 为 text/xml 和 application/xml， 写 支持 的 响应 类 型 
为 text/xml 和 application/xml 
数据 与 java.awt.image.BufferedImage 的 相互 转换 。 读 支持 
BufferedImageHttpMessageConverter MediaType 为 Java IO API 的 所 有 类 型 ， 写 支持 的 响应 类 型 为 
Java IO API 的 所 有 类 型 。 


除了 表 6-9 中 列 出 的 HttpMessageConverter 接口 实现 类 外 ， 还 有 很 多 实现 类 无 法 一 一 阐述 ， 
读者 可 以 自己 阅读 Spring MVC 源码 学 习 。 


6.3.2 RequestMappingHandlerAdapter 


在 Spring MVC 中 配置 <mvc:annotation-driven/> 标 签注 册 三 个 bean: 


© RequestMappingHandlerMapping 
© RequestMappingHandlerAdapter 
© DefaultHandlerExceptionResolver 


DispatcherServlet 默认 已 经 装配 RequestMappingHandlerAdapter 作为 HandlerAdapter 组 件 的 
实现 类 ， 即 HttpMessageConverter 由 RequestMappingHandlerAdapter 使 用 ， 将 请 求 信息 转换 为 对 
象 ， 或 者 将 对 象 转换 为 响应 信息 。RequestMappingHandlerAdapter 具体 源码 如 下 所 示 : 


public class RequestMappingHandlerAdapter extends 
AbstractHandlerMethodAdapter 
implements BeanFactoryAware, InitializingBean { 


// 省 略 大 量 代码 


private List<HttpMessageConverter<?>> messageConverters; 


public RequestMappingHandlerAdapter() { 
StringHttpMessageConverter stringHttpMessageConverter 
= new StringHttpMessageConverter(); 
stringHttpMessageConverter.setWriteAcceptCharset (false); 

// see SPR-7316 
this.messageConverters = new ArrayList<>(4); 
this.messageConverters.add (new ByteArrayHttpMessageConverter ()); 
this.messageConverters.add (stringHttpMessageConverter); 
this.messageConverters.add (new SourceHttpMessageConverter<>()); 


仅 供 非 商 业 用 途 或 交流 学 习 使 用 LD 
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this.messageConverters.add (new 
AllEncompassingFormHttpMessageConverter()); 


} 


由 RequestMappingHandlerAdapter 源码 可 知 ，RequestMappingHandlerAdapter 构造 方法 默认 
已 经 装配 了 以 下 的 HttpMessageConverter: 


© ByteArrayHttpMessageConverter 

e StrngHttpMessageConverter 

@ SourceHttpMessageConverter 

© AllEncompassingFormHttpMessageConverter 


6.3.3” 自 定义 HttpMessageConverter 


如 果 需 要 装配 其 他 类 型 的 HttpMessageConverter， 则 可 以 在 Spring 的 Web 容器 的 上 下 文中 自 
定义 一 个 RequestMappingHandlerAdapter。 需 要 注意 的 是 ， 如 果 在 Spring 的 Web 容器 的 上 下 文中 
自 定 义 一 个 RequestMappingHandlerAdapter， 那 么 Spring MVC 的 RequestMappingHandlerAdapter 
默认 装配 的 HttpMessageConverter 将 不 再 起 作用 。spring-mvc.xml 配置 信息 有 具体 代码 如 下 : 


<!-- 自 定义 RequestMappingHandlerAdapter --> 
<bean class="org.springframework.web.servlet.mvce.method 
.annotation.RequestMappingHandlerAdapter"> 
<property name="messageConverters"> 
< DIS 七 > 
<bean 
class="org.springframework.http.converter.ByteArrayHttpMessageConverter"/> 
<bean 
class="org.springframework.http.converter.StringHttpMessageConverter"/> 
<bean 
class="org.springframework.http.converter.xml.SourceHttpMessageConverter"/> 
</Tst> 
</property> 
</bean> 


<lis 从 标签 中 除了 使 用 Spring MVC 为 我 们 提供 的 HttpMessageConverter 接口 实现 类 外 ， 还 
可 以 通过 继承 AbstractHttpMessageConverter 实现 适合 自己 的 HttpMessageConverter。 


仅 供 非 商 业 用 途 或 交流 学 习 使 


非 卖 品 ， 仅 供 非 商业 用 途 或 交流 学 习 使 用 


Spring 数据 校 验 


本 章 将 介绍 Spring 的 Validation 校 验 框架 、JSR 303 校 验 以 及 常用 的 注解 。 
7.1 ”数据 校 验 概述 


在 Web 应 用 程序 中 ， 为 了 防止 客户 端 传 来 的 数据 引发 程序 异常 ， 常 常 需要 对 数据 进行 验 
证 。 数 据 验证 分 为 客户 端 验证 与 服务 器 端 验证 。 客 户 端 验证 主要 通过 JavaScript 脚本 进行 ， 而 服 
务 器 端 验证 则 主要 通过 Java 代码 进行 验证 。 为 了 保证 数据 的 安全 性 ， 客 户 端 和 服务 器 端 验证 都 是 
必须 的 。 

Spring MVC 提供 了 强大 的 数据 校 验 功能 ， 其 中 有 两 种 方法 可 以 验证 输入 : 


(1) 利用 Spirng 自 带 的 Validation 校 验 框架 。 
(2) 利用 JSR 303 (Java 检验 规范 ) 实现 校 验 功能 。 


下 面 详 细 介 绍 两 种 校 验 方法 。 


仅 供 非 商业 用 途 或 交流 学 习 使 


非 卖 品 ， 仅 供 非 商业 用 途 或 交流 学 习 使 
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7.2 Spring 的 Validation 校 验 框 架 


Spring 提供 了 Validator 接口 来 校 验 对 象 ，Validator 接口 源码 如 下 所 示 : 


public interface Validator { 
boolean supports (Class<?> clazz); 
void validate (@Nullable Object target, Errors errors); 


e boolean supports(Class<?> clazz): 校 验 器 能 够 对 clazz 类 型 的 对 象 进行 校 验 。 

e validate(@Nullable Object target, Errors errors): 对 目标 类 target 进 行 校 验 ， 并 将 校 验 
错误 记录 在 errors 中 。 

e@ Errors 类 : 用 来 存放 错误 信息 的 接口 。Errors 对 象 包含 一 系列 的 FieldError 和 ObjectError 
对 象 。FieldError 表 示 与 被 获取 的 对 象 中 的 某 一 属性 相关 的 一 个 错误 。 


除了 Validator 和 Errors 对 象 之 外 ，Spring 的 Validation 校 验 框架 还 提供 了 其 他 重要 的 接口 ; 


e ValidationUtils: 校 验 工 具 类 ， 提 供 多 个 给 Errors 对 象 保 存 错误 的 方法 。 
e LocalValidatorFactoryBean: 该 类 实现 了 Spring 的 Validator 接 口 ， 也 实现 了 JSR 303 的 
Validator 接 口 。 


在 实际 开发 过 程 中 ，spring-mvc.xml 配置 文件 中 的 <mvc:annotation-driven/> 会 默认 装配 好 
LocalValidatorFactoryBean ， 所 以 在 实际 开发 过 程 中 不 需要 手动 配置 
LocalValidatorFactoryBean。 下 面 来 看 一 个 具体 的 实例 。 

首先 ， 在 src\main\java\com\ay\imodel 目录 下 创建 AyUser 实体 类 (之 前 章节 已 创建 )， 具 体 


代码 如 下 所 示 : 


/** 

* 用 户 实体 

* Qauthor Ay 

* @date 2018/04/02 
/6 


public class AyUser implements Serializablel{ 


private Integer id; 
private String name; 
private String password; 


private Integer age; 


仅 供 非 商 业 用 途 或 交流 学 习 使 用 


非 卖 品 ， 仅 供 非 商业 用 途 或 交流 学 习 使 
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将 


// 省 略 set、get 方法 
} 


其 次 ， 在 src\mainYjava\com\ay\validator 目录 下 创建 用 户 数据 校 验 类 AyUserValidator， 具 体 
代码 如 下 所 示 : 
/** 
* 描述 : 用 户 数据 校 验 类 
* Qauthor Ay 
* Qcreate 2018/05/25 
*x*/ 
@Component 


public class AyUserValidator implements Validator { 


/** 

* This Validator validates *just* AyUser instances 
*1 

public boolean supports(Class clazz) { 


return AyUser.class.equals (clazz); 


public void validate (Object obj, Errors e) I 
// 指 定 errors 对 象 、 验 证 失败 的 字段 、 错 误 码 
ValidationUtils.rejectIifEmpty(e, "name", "name.empty"); 
AyUser p = (AyUser) obj; 
if (p.getAge() < 0) { 
e.rejectValue ("age", "年 龄 不 能 小 于 0 岁 "); 
} else if (p.getAge() > 150) { 
e.rejectValue ("age", "年 龄 不 能 超过 150 岁 ") ; 


} 


AyUserValidator 类 实现 Validator 接口 ， 并 实现 supports() 和 validate() 方 法 。 在 supports() 方 
法 中 使 用 ValidationUtils 的 静态 方法 rejectIfEmpty0 对 name 和 age 属性 进行 校 验 。 假 如 name 属 
性 是 null 或 者 空 字符 串 ， 就 拒绝 验证 通过 。 假 如 age 属性 的 值 年 龄 小 于 0 岁 或 者 大 于 150 岁 ， 
就 拒绝 验证 通过 。 通 过 使 用 Errors 对 象 的 rejectValue 方法 保存 校 验 信息 。 

最 后 ， 在 src\main\webapp\WEB-INF\views 目录 下 创建 保存 用 户 页 面 saveUser.jsp， 上 有 具体 代 
码 如 下 所 示 : 


仅 供 非 商 业 用 途 或 交流 学 习 使 用 


非 卖 品 ， 仅 供 非 商业 用 途 或 交流 学 习 使 
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<%@page language="java" contentType="text/html; charset=UTF-8" 
pageEncoding="UTF-8" isELIgnored="false"s%> 
<!DOCTYPE HTML> 
<html> 
<head> 
<title>Getting Started: Serving Web Content</title> 
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8" /> 
</head> 
<body> 
<form method="post" action="/user/insert" > 
<table> 
Ee 
<td> 姓 名 : </td> 
<td><input id="name" name="name" type="text"></td> 
< 六 
> 
<td> 密 码 : </td> 
<td><input id="password" name="password" type="text"></td> 
</Er> 
> 
<td> 年 龄 : </td> 
<td><input id="age" name="age" type="text"></td> 
AD 
Xu > 
<td><input type="submit" value=" 提 交 "></td> 
/ET 
</table> 
</form> 
</body> 
<script></script> 
</htmi> 


页 面 saveUser.jsp 创建 完成 之 后 ， 在 控制 层 AyUserController 添加 相关 的 代码 ， 有 具体 如 下 ; 


@Controller 
CRequestMapping ("/user") 
public class AyUserController { 


@Resource 
private AyUserValidator ayUserValidator; 


非 卖 品 ， 仅 供 非 商业 用 途 或 交流 学 习 使 用 


a 
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[ 


@RequestMapping ("/save") 
public String save() { 


return "saveUser"; 


@PostMapping ("/insert") 
public String insert (@ModelAttribute AyUser ayUser,Model] model, Errors 
errors){ 
ayUserValidator.validate(ayUser, errors); 
if(errors.hasErrors())I{ 
// 将 错误 存放 到 model 中 
model.addAttribute ("errors", errors); 
Beturn errory, 
} 
int count = ayUserService.insert (ayUser); 
return Success 7 


} 


在 控制 层 类 AyUserController 中 ， 注 入 AyUserValidator 校 验 类 ， 同 时 在 insert 方法 中 调用 
AyUserValidator 类 的 validate 方法 进行 校 验 。 如 果 数 据 校 验 正确 ， 返 回 成 功 (success) 界面 ; 如 
果 数 据 校 验 失败 ， 返 回 错 误 (error) 界面 。 

success.jsp 页 面 如 下 所 示 : 


<g%epage language="java" contentType="text/html; charset=UTF-8" 
pageEncoding="UTF-8" isELIgnored="false"%®> 
<!IDOCTYPE HTML> 
<html> 
<head> 
<title>Getting Started: Serving Web Content</title> 
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8" /> 
</head> 
<body> 
success ll) 
</body> 
<script></script> 
</html> 


error.jsp 页 面 如 下 所 示 : 


<%Q@page language="java" contentType="text/html; charset=UTF-8" 
pageEncoding="UTF-8" isELIgnored="false"%®> 


非 卖 品 ， 仅 供 非 商业 用 途 或 交流 学 习 使 
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< DOCTY PE HEME> 

<html> 

<head> 
<title>Getting Started: Serving Web Content</title> 
<meta http-~equiv="Content-Type" content="text/html; charset=UTF-8" /> 

</head> 

<body> 

error !!! 

</body> 

<SCLlDES</ASCrLDt> 

</html> 


代码 开发 完成 之 后 ， 重 新 启动 Tomcat 服务 器 ， 项 目 启动 成 功 后 ， 在 浏览 器 中 输入 访问 
URL: http://localhost:8080/user/save， 出 现 保 存 用 户 界面 ， 具 体 如 图 7-1 所 示 。 

在 保存 用 户 页 面 中 填写 用 户 信 息 (姓名: ay; 密码 : 123; 年 龄 : 199) ， 然 后 单 击 “ 保 存 ” 
按钮 ， 由 于 年 龄 不 符合 数据 校 验 规则 ， 故 返回 到 错误 界面 ， 具体 如 图 7-2 所 示 。 


< © | © localhost:8080/user/save 
5 应 用 . 浇 百度 兰 【搜索 】 兰 [CSDN] 


姓名 : ay CY @ localhost8080/userinsert 


密码 : 23 浇 应 用 党 二 度 ” 兰 [ 搜 过 兰 [CSDN] 
年 险 : 


保存 


图 7-1 保存 用 户 界 面 图 7-2 保存 错误 界面 


由 于 Spring Validation 框架 通过 硬 编码 完成 数据 校 验 ， 在 实际 开发 过 程 中 会 显得 比较 麻 
烦 ， 因 此 更 加 推荐 使 用 JSR 303 完成 数据 校 验 。 


7.3 JSR 303 校 验 


JSR 303 是 Java 为 Bean 数据 合法 性 校 验 提 供 的 标准 框架 ， 已 经 包含 在 Java EE 6.0 中 。JSR 
是 一 个 规范 ， 它 的 核心 接口 是 Validator， 该 接口 根据 目标 对 象 类 中 所 标注 的 校 验 注解 进行 数据 
校 验 ， 并 得 到 校 验 结果 。JSR 303 通过 在 Bean 属性 中 标注 类 似 @NotNull、@Max 等 标准 的 注解 

肯定 校 验 规 则 ， 并 通过 标准 的 验证 接口 对 Bean 进行 验证 。JSR 303 包含 的 详细 注解 如 表 7-1 所 示 。 
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表 7-1 JSR 303 包含 注解 


注解 名 称 描 述 

@Null 被 注释 的 元 素 必须 为 null 

@NotNull 被 注释 的 元 素 必须 不 为 null 

@AssertTrue 被 注释 的 元 素 必须 为 true 

@AssertFalse 被 注释 的 元 素 必须 为 false 

@Min(value) 被 注释 的 元 素 必须 是 一 个 数字 ， 其 值 必须 大 于 等 于 指定 的 最 小 值 
@Max(value) 被 注释 的 元 素 必须 是 一 个 数字 ， 其 值 必须 小 于 等 于 指定 的 最 大 值 
@DecimalMin(value) 被 注释 的 元 素 必 须 是 一 个 数字 ， 其 值 必须 大 于 等 于 指定 的 最 小 值 
@Decimal Max(value) 被 注释 的 元 素 必须 是 一 个 数字 ， 其 值 必须 小 于 等 于 指定 的 最 大 值 
@Size(max=, min-) | 被 注释 的 元 素 的 大 小 必须 在 指定 的 范围 内 

@Digits (integer, fraction) ”| 被 注释 的 元 素 必须 是 一 个 数字 ， 其 值 必 须 在 可 接受 的 范围 内 
@Past 被 注释 的 元 素 必须 是 一 个 过 去 的 日 期 

@Future 被 注释 的 元 素 必须 是 一 个 将 来 的 日 期 

@Pattern(regex=,flag=) 被 注释 的 元 素 必 须 符合 指定 的 正则 表达 式 


HIbernate Validator 是 JSR 303 的 一 个 参考 实现 ， 除 了 支持 所 有 标准 的 校 验 注 解 外 ， 还 支持 
一 些 扩展 注解 ， 具 体内 容 如 表 7-2 所 示 。 


表 7-2” Hibernate Validator 附加 的 注解 


注解 名 称 描 述 

@NotBlank(message =) 验证 字符 串 非 null， 且 长 度 必 须 大 于 0 
@Email 被 注释 的 元 素 必须 是 电子 邮箱 地 址 
@Length(min=,max=) 被 注释 的 字符 串 的 大 小 必须 在 指定 的 范围 内 
@NotEmpty 被 注释 的 字符 串 必须 非 空 


@Range(min=,max=,message=) 


被 注释 的 元 素 必须 在 合适 的 范围 内 


@URL 


被 注释 的 元 素 必 须 是 合法 的 URL 


下 面 来 看 一 个 具体 的 实例 。 
首先 ， 在 pom.xml 文件 中 引入 Hibernate Validator 所 需要 的 依赖 包 ， 具 体 代 码 如 下 所 示 : 


<dependency> 


<grouplId>org.hibernate.validator</groupId> 
<artifactIid>hibernate-validator</artifactId> 
<version>6.0.10.Final</version> 


</dependency> 
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其 次 ， 在 srcmainvwebapp\WEB-INFVviews 目录 下 创建 保存 用 户 页 面 saveUser.jsp 和 
AyUser.java。 


AyUser.java 实体 类 具体 代码 如 下 所 示 : 


/** 

* 用 户 实体 

* @author Ay 

* @date 2018/04/02 


public class AyUser implements Serializablel 


private Integer id; 
@NotBlank (message = "name 不 能 为 空 ") 
private String name; 


"密码 长 度 必须 在 3~16 位 之 间 ") 


QLength (min = 3, max = 16, message 
private String password; 


和 


"年 龄 必须 在 0~150 岁 之 间 ") 


GRange (min = 0, max = 150, message 
private Integer age; 
// 省 略 set、get 方法 

} 


saveUser.jsp 具体 代码 如 下 所 示 : 


<s@page language="java" contentType="text/html; charset=UTF-8" 
pageEncoding="UTF-8" isELIgnored="false"%> 
<!IDOCTYPE HTML> 
<html> 
<head> 
<title>Getting Started: Serving Web Content</title> 
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8" /> 
</head> 
<body> 
<form method="post" action="/user/insert" > 
<table> 
< > 
<td> 姓 名 : </td> 
<td><input id="name" name="name" type="text"></td> 
</tr> 
<tr> 
<td> 密 码 : </td> 
<td><input id="password" name="password" type="text"></td> 
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<td> 年 龄 :</td> 
<td><input id="age" name="age" type="text"></td> 
< ble> 
<tr> 
<td><input type="submit" value=" 保 存 "></td> 
< Atr> 
</table> 
</form> 
</body> 
<script></script> 
</html> 


最 后 ， 在 AyUserController 类 中 添加 相关 的 方法 ， 具 体 代 码 如 下 所 示 : 
/炎炎 

* 用 户 控 制 层 

*Qauthor Ay 

* @date 2018/04/02 

wh 

QController 

@RequestMapping ("/user") 

public class AyUserController { 


@RequestMapping ("/save") 
public String save()t 


return "saveUser"; 


@PostMapping ("/insert") 
public String insert (@Valid AyUser ayUser, Model model, 
BindingResult result)f{ 


if(errors.hasErrors()){ 
model.addAttribute ("errors", errors); 
reburnm verrory, 

} 

int count = 三 ayUserService.insert (ayUser); 


return "success"; 
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e BindingResult: BindingResult 扩 展 了 Errors 接 口 ， 同 时 可 以 获取 数据 绑 定 结果 对 象 的 信 
息 。@Valid 和 BindingResult 参 数 是 成 对 出 现 的 ， 并 且 在 形 参 中 出 现 的 顺序 是 固定 的 ， 
一 前 一 后 。 


在 AyUserController 类 中 insert() 方 法 使 用 @Valid 注解 对 提交 的 数据 进行 校 验 ， 同 时 insert() 
方法 使 用 Errors 对 象 保存 校 验 信 息 。 代 码 开 发 完成 之 后 ， 在 浏览 器 输入 访问 路 径 : 
http://localhost:8080/user/save， 可 以 看 到 保存 用 户 界面 ， 具 体 如 图 7-3 所 示 。 


be © localhost:8080/user 
党 百度 兰 【搜索 】 兰 [CSDN] 


图 7-3 保存 用 户 界面 


在 保存 用 户 界 面 中 ， 填 写 相关 的 用 户 信息 〈 姓 名 : ay， 密 码 : 1， 年 龄 ，150〉 并 单 击 “ 保 
存 ” 按 钮 ， 由 于 密码 的 长 度 要 求 是 3~16 位 ， 故 可 以 在 控制 台 看 到 数据 校 验 错误 信息 ， 具 体 如 
图 7-4 所 示 。 


Field error in object "ayUser” on field "password : rejected value |]: 

codes [Length. ayUser. password, Length. password, Length. java. lang. String, Length]; 

arguments Lorg. springtramework. context. support. DefaultMessageSourceResolvable: 
dj 1 1]: defaulit message [password}, 16,3]; 


“ariiiotation. ModelAttributeMethodProcessoy 
.method. support, HandlerMethodArgumentResolverCon 
vomowork Wab. nefhod. SUDO Tnocah edd er dela et th 
anioworit web. nethod. Supont. TnvocallodandlerMoihod Srvokene 

rg. springtframework. web. servlet. myc. method. annotation. ServletInvocable 
at org. springframework. web. serviet. mve. method. annotation. RequestMappingHar 
at org. springframework. web, serviet. mve. method. annotation. RequestMappingHa 
at org. springtramework. web. servi et. mvye. method. AbstractHandlerMethodAdaptse 
at org. springframework. Ww t. DispatcherServlet. doDispatch (Dispatchedl 
t org. springframework. web, serviet. DispatcherServlet. doService (Dispatcher: 
. springframework, web. servlet. FrameworkServiet. processRedquest (Framew 


图 7-4 用 户 校 验 错误 信息 


Spring 和 MyBatis 事务 管理 


本 章 将 介绍 Spring 事务 管理 ， 包 括 Spring 声明 式 事务 、Spring 注解 事务 行为 和 MyBatis 事 
务 管 理 。 


8.1 Spring 事务 管理 


8.1.1 Spring 事务 回顾 


事务 管理 是 企业 级 应 用 程序 开发 中 必 不 可 少 的 技术 ， 用 来 确保 数据 的 完整 性 和 一 致 性 。 事 
务 有 4 大 特性 (ACID) : 原子 性 (atomicity) 、 一 致 性 〈consistency) 、 隔 离 性 〈isolation ) 和 
持久 性 (durability〉。 作 为 企业 级 应 用 程序 框架 ，Spring 在 不 同 的 事务 管理 API 之 上 定义 了 一 
个 抽象 层 ， 而 应 用 程序 开发 人 员 不 必 了 人 解 底层 的 事务 管理 API， 就 可 以 使 用 Spring 的 事务 管理 
机 制 。 

Spring 既 支 持 编程 式 事务 管理 〈 也 称 编 码 式 事 务 ) ， 也 支持 声明 式 的 事务 管理 。 编 程式 事 
务 管理 是 指 将 事务 管理 代码 拘 入 到 业务 方法 中 来 控制 事务 的 提交 和 回 深 。 在 编程 式 事务 中 ， 必 
须 在 每 个 业务 操作 中 包含 额外 的 事务 管理 代码 。 声 明 式 事务 管理 是 指 将 事务 管理 代码 从 业务 方 
法 中 分 离 出 来 ， 以 声明 的 方式 来 实现 事务 管理 。 大 多 数 情况 下 声明 式 事务 管理 比 编程 式 事务 管 
理 更 好 用 。Spring 通过 Spring AOP 框架 支持 声明 式 事务 管理 。 


全 
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数据 访问 的 技术 很 多 ， 如 JDBC、JPA、Hibernate、 分 布 式 事务 等 ， 面 对 众多 的 数据 访问 技 
术 ，Spring 并 不 直接 管理 事务 ， 而 是 提供 了 许多 内 置 事务 管理 器 实现 ， 常 用 的 有 : 
DataSourceTransactionManager 、 JdoTransactionManager 、 JpaTransactionManager 及 


HibernateTransactionManager 等 。 


8.1.2 Spring 声明 式 事务 


Spring 配置 文件 中 关于 事务 配置 总 是 由 三 个 组 成 部 分 ， 分 别 是 DataSource 、 
TransactionManager 和 代理 机 制 。 无 论 哪 种 配置 方式 ， 一 般 变 化 的 只 是 代理 机 制 这 部 分 ， 
DataSource 和 TransactionManager 这 两 部 分 只 会 根据 数据 访问 方式 有 所 变化 ， 比 如 使 用 Hibernate 
进行 数据 访问 时 ，DataSource 实现 为 SessionFactory ， TransactionManager 的 实现 为 
HibernateTransactionManager。 

Spring 声明 式 事务 配置 提供 5 种 方式 ， 而 基于 Annotation 注解 方式 目前 比较 流行 ， 所 以 这 
里 只 简单 介绍 基于 注解 方式 配置 Spring 声明 式 事务 。 可 以 使 用 @Transactional 注解 在 类 或 者 方 
法 上 表明 该 类 或 者 方法 需要 事务 支持 ， 被 注解 的 类 或 者 方法 被 调用 时 ，Spring 开启 一 个 新 的 事 
务 ， 当 方法 正常 运行 时 ，Spring 会 提交 这 个 事务 。 有 具体 例子 如 下 : 

Transactional 


public AyUser update() { 


// 执 行 数据 库 操作 
} 


同时 需要 在 applicationContext.xml 文件 中 添加 事务 相关 的 配置 ， 具 体 代码 如 下 所 示 : 
<!-- 声明 式 事务 --> 


<tx:annotation-driven transaction-manager="transactionManager" 
proxy-target-class="true" /> 
<bean id="transactionManager" 
class="org.springframework.jdbc.datasource. 
DataSourceTransactionManager"> 
<property name="dataSource" ref="dataSource" /> 
</bean> 


这 里 需要 注意 的 是 ，@Transactional 注解 来 自 org.springframework.transaction.annotation， 
Spring 提供 了 @EnableTransactionManagement 注解 在 配置 类 上 来 开启 声明 式 事务 的 支持 ， 使 用 
@EnableTransactionManagement 后 ，Spring 容器 会 自动 扫描 注解 @Transactional 的 方法 和 类 。 
8.1.3 Spring 注解 事务 行为 

当 事 务 方法 被 另 一 个 事务 方法 调用 时 ， 必 须 指定 事务 应 该 如 何 传播 。 例 如 ， 方 法 可 能 继续 


| 
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在 现 有 事务 中 运行 ， 也 可 能 开启 一 个 新 事务 ， 并 在 自己 的 事务 中 运行 。 事 务 的 传播 行为 可 以 在 
@Transactional 的 属性 中 指定 ，Spring 定义 了 7 种 传播 行为 ， 具 体 如 表 8-1 所 示 。 


表 8-1 Spring 传播 行为 
传播 行为 全 
如 果 当 前 没有 事务 ， 就 新 建 一 个 事务 ， 如 果 已 经 存在 一 个 事务 ， 
加 入 到 这 个 事务 中 
PROPAGATION _ SUPPORTS 支持 当前 事务 ， 如 果 当 前 没有 事务 ， 就 以 非 事务 方式 执行 
PROPAGATION MANDATORY 使 用 当前 的 事务 ， 如 果 当 前 没有 事务 ， 就 抛 出 异常 
PROPAGATION REQUIRES NEW | 新 建 事 务 ， 如 果 当 前 存在 事务 ， 把 当前 事务 挂 起 
PROPAGATION NOT_ SUPPORTED | 以 非 事 务 方式 执行 操作 ， 如 果 当 前 存在 事务 ， 就 把 当前 事务 挂 起 
PROPAGATION_ NEVER 以 非 事 务 方式 执行 ， 如 果 当 前 存在 事务 ， 则 抛 出 异常 


如 果 当 前 存在 事务 ， 则 在 肉 套 事务 内 执行 。 如 果 当 前 没有 事务 ， 
则 执行 与 PROPAGATION _ REQUIRED 类似 的 操作 


隔离 级 别 定义 了 一 个 事务 可 能 受 其 他 并 发 事务 影响 的 程度 。 在 典型 的 应 用 程序 中 ， 多 个 事 
务 并 发 运行 ， 经 常会 操作 相同 的 数据 来 完成 各 自 的 任务 。 并 发 虽然 是 必须 的 ， 但 也 可 是 会 导致 
许多 问题 ， 并 发 事务 所 导致 的 问题 可 以 分 为 以 下 三 类 : 
@ 脏 读 (Dirty reads ) : 脏 读 发 生 在 一 个 事务 读 取 了 另 一 个 事务 改写 但 尚未 提交 的 数据 。 
如 果 改 写 在 稍 后 被 回 滚 了 ， 那 么 第 一 个 事务 获取 的 数据 就 是 无 效 的 。 
@ 不 可 重复 读 (Nonrepeatable read ) : 不 可 重复 读 发 生 在 一 个 事务 执行 相同 的 查询 两 次 或 
两 次 以 上 ， 但 是 每 次 都 得 到 不 同 的 数据 时 。 这 通常 是 因为 另 一 个 并 发 事务 在 两 次 查询 
期 间 更 新 了 数据 。 
e 幻 读 (Phantom read ) : 幻 读 与 不 可 重复 读 类 似 。 它 发 生 在 一 个 事务 (T1 ) 读 取 了 几 行 
数据 ， 接 着 另 一 个 并 发 事务 (T1 ) 插入 了 一 些 数据 时 。 在 随后 的 查询 中 ， 第 一 个 事务 
(T1 ) 就 会 发 现 多 了 一 些 原本 不 存在 的 记录 。 


针对 这 些 问 题 ，Spring 提供 了 5 种 事务 的 隔离 级 别 ， 具 体 如 表 5-2 所 示 。 
表 8-2 Spring 隔离 级 别 


PROPAGATION REQUIRED 


PROPAGATION_NESTED 


隔离 级 别 人 
GOL OR LERALD 使 用 数据 库 默 认 的 事务 隔离 级 别 ， 另 外 4 个 与 JDBC 的 隔离 级 
一 别 相对 应 


事务 最 低 的 隔离 级 别 ， 它 允许 另外 一 个 事务 可 以 看 到 这 个 事务 
ISOLATION _ READ_UNCOMMITTED | 未 提交 的 数据 。 这 种 隔离 级 别 会 产生 脏 读 ， 不 可 重复 读 和 幻 
像 读 
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( 续 表 ) 

隔离 级 别 富 
ISOLATION READ COMMITTED 使 用 当前 的 事务 ， 如 果 当 前 没有 事务 ， 就 抛 出 异常 
ISOLATION REPEATABLE READ 新 建 事务 ， 如 果 当 前 存在 事务 ， 把 当前 事务 挂 起 
以 非 事务 方式 执行 操作 ， 如 果 当 前 存在 事务 ， 就 把 当前 事务 
挂 起 

@Transactional 可 以 通过 propagation 属性 定义 事务 行为 ， 属 性 值 分 别 为 : REQUIRED、 
SUPPORTS、MANDATORY、REQUIRES NEW、 NOT_ SUPPORTED、NEVER 及 NESTED， 
分 别 对 应 表 8-1 中 的 内 容 。 可 以 通过 isolation 属性 定义 隔离 级 别 ， 属 性 值 分 别 为 ， DEFAULT、 
READ_UNCOMMITTED、READ_ COMMITTED、REPEATABLE_ READ 及 SERIALIZABLE. 

还 可 以 通过 timeout 属性 设置 事务 过 期 时 间 ， 通 过 readOnly 指定 当前 事务 是 否 是 只 读 事 
务 ， 通 过 rollbackFor (CnoRollbackFor) 指定 那个 或 者 那些 异常 可 以 引起 〈 或 不 可 以 引起 ) 事务 
回 滚 。 


ISOLATION SERIALIZABLE 


8.2 ”MyBatis 事务 管理 


MyBatis 使 用 Transaction 接口 对 数据 库 事务 进行 了 抽象 ，Transaction 接口 的 定义 如 下 : 


public interface Transaction { 

// 获 取 数 据 库 连 接 对 象 

Connection getConnection() throws SQLException; 
// 提 交 事务 

void commit() throws SQLException; 
// 回 滚 事务 

void rollback() throws SQLException; 
// 关 闭 数据 库 连 接 

void close() throws SQLException; 
// 获 取 事 务 超时 时 间 


Integer getTimeout() throws SQLException; 


} 


Transaction 接口 有 两 个 实现 类 ， 即 JdbcTransaction 和 ManagedTransaction， 分 别 由 
JdbcTransactionFactory 和 ManagedTransactionFactory 负责 创建 ， 有 具体 如 图 8-1 所 示 。 


非 卖 品 ， 仅 供 非 商业 用 途 或 交流 学 习 使 
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二 TransactionFactory | 


| 
本 二 JdbcTransactionFactory | © 5 ManagedTransactionFactory 


Bl 3 JdbcTransaction | ManagedTransaction 


ni 


区 人 Transaction | 


图 8-1 事务 类 继承 关系 


JdbcTransaction 依赖 JDBC 的 Connection 控制 事务 的 提交 和 回 滚 ，JdbcTransaction 源码 如 下 
所 示 : 


public class JdbcTransaction implements Transaction f 
// 省 略 代码 
// connection 对 象 会 延迟 初始 化 


protected Connection connection; 


protected DataSource dataSource; 

protected TransactionIsolationLevel level; 
// MEMO: We are aware of the typo. See #941 
protected boolean autoCommmit; 


public JdbcTransaction (DataSource ds, TransactionIsolationLevel 
desiredLevel, boolean desiredAutoCommit) { 
dataSource = ds; 
level = desiredLevel; 
autoCommmit = desiredAutoCommit; 


@Override 
public void commit() throws SQLException { 
if (connection != null && !connection.getAutoCommit()) { 
if (log.isDebugEnabled()) { 


} 


非 卖 品 ， 仅 供 非 商业 用 途 或 交流 学 习 使 
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log.debug ("Committing JDBE Connection [Dt CoOnneotuon Tl]) 
} 
// 使 用 connection 的 commit 功能 


Connection.cormmit () ; 


@Override 
public void rollback() throws SQLException { 
if (connection != null && !connection.getAutoCcommit()) { 
if (log.isDebugEnabled()) { 
log.deBbug ("RolLing back JDBC Connection [|" + connection T° )27 

} 
// 使 用 connection 的 rollback 功能 
connection.rollback(); 


QOverride 
public void close() throws SQLException { 
if (connection != null) { 
resetAutoCommit () 
if (log.isDebugEnabled()) { 
log.debug( "OlLosing JDBC Connection [MT Connecerom ht |)» 
} 
// 使 用 connection 的 rollback 功能 
connection.close()y 


由 上 述 代码 可 知 ，JdbcTransaction 直接 使 用 JDBC 的 提交 和 回 滚 事务 机 制 ， 它 依赖 于 从 
dataSource 中 取得 connection 连接 来 管理 事务 。JdbcTransaction 只 是 对 java.sql.Connection 事务 进 


行 了 昨 


了 次 封装 ，JdbcTransaction 对 象 在 初始 化 时 ， 构 造 方法 会 初始 化 DataSource、 


TransactionIsolationLevel 和 boolean desiredAutoCommit 字段 ， 而 connection 字段 会 延迟 初始 化 ， 
它 会 在 调用 getConnection() 方 法 时 ， 通 过 dataSurce.getConnection() 方 法 初始 化 。 

ManagedTransaction 同样 是 依赖 dataSource 字段 获取 连接 ， 但 是 其 commit()、rollback() 方 法 
都 是 空 实 现 ， 事 务 的 提交 和 回 深 都 是 依靠 容器 管理 的 。ManagedTransaction 通过 closeCollection() 
字段 的 值 控制 数据 库 连 接 的 关闭 行为 。ManagedTransaction 源码 如 下 所 示 : 


非 卖 品 ， 仅 供 非 商业 用 途 或 交流 学 习 使 
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public class ManagedTransaction implements Transaction { 


private static final Log 109 = LogFactory.getLog (ManagedTransaction.class); 

private DataSource dataSource; 

private TransactionIsolationLevel level; 

private Connection connection; 

private final boolean closeConnection; 

// 构 造 方法 

public ManagedTransaction (Connection connection, boolean closeConnection) { 
this.connection = connection; 


this.closeConnection = closeConnection; 


public ManagedTransaction (DataSource ds, TransactionIsolationLevel level, 
boolean closeConnection) { 
this.dataSource = ds; 
this.level = level; 
this.closeConnection = closeConnection; 


QOverride 

public Connection getConnection() throws SQLException { 
TF (Chis CoNnnectlion == null)e 

openConnection(); 

} 
return this.connection; 

} 

// 空 实现 

GOverride 

public void commit() throws SQLException { 
// Does nothing 

} 

// 空 实现 

QOverride 

public void rollback() throws SQLException { 
// Does nothing 


QOverride 
public void close() throws SQLException { 


仅 供 非 商 业 用 途 或 交流 学 习 使 / 


非 卖 品 ， 仅 供 非 商业 用 途 或 交流 学 习 使 
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if (this.closeConnection && this.connection != null) { 
if (log.isDebugEnabled()) { 
log.debug ("Closing JDBC Connection |[" + this.connection + "|"); 


} 


this.connection.close(); 


protected void openConnection() throws SQLException { 
if (log.isDebugEnabled()) { 
log.debug ("Opening JDBC Connection"); 


} 
this.connection = this.dataSource.getConnection(); 


if (this.level != null) { 
this.connection.setTransactionIsolation(this.level.getLevel ()); 


@Override 
public Integer getTimeout() throws SQLException { 


return null; 


仅 供 非 商 业 用 途 或 交流 学 习 使 
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MyBatis 缓存 机 制 


本 章 将 介绍 MyBatis 缓存 机 制 ， 包 括 一 级 缓 在 和 二 级 缓存 以 及 一 级 缓存 和 二 级 缓存 的 使 用 


9.1 MyBatis 的 缓存 模式 


缓存 在 互联 网 系统 中 是 非常 重要 的 ， 其 主要 作用 是 将 数据 保存 到 内 存 中 ， Re 
时 ， 优 先 从 缓存 容器 中 获取 数据 ， 而 不 是 频繁 地 从 数据 库 中 查询 数据 ， 从 而 提高 查询 性 能 。 

前 流行 的 缓存 服务 器 有 MongoDB、Redis、Ehcache 等 ， tt 
不 存在 熟 优 训 劣 。 

MyBatis 提供 一 级 缓存 和 二 级 缓存 的 机 制 。 一 级 缓存 是 SqlSession 级 别 的 缓存 , 在 操作 数据 
库 时 ， 每 个 SqlSession 类 的 实体 对 象 中 都 有 一 个 HashMap 数据 结构 可 以 用 来 缓存 数据 ， 不 同 的 
SqlSession 类 的 实例 对 象 缓存 的 HashMap 数据 结构 互 不 影响 。 二 级 缓存 是 Mapper 级 别 的 缓存 ， 
多 个 SqlSession 类 的 实例 对 象 操 作 同 一 个 Mapper 配 置 文件 中 的 SQL 语句 ， 可 以 共用 二 级 缓存 ， 
二 级 缓存 是 跨 SqlSession 的 。 这 里 需要 注意 的 是 ， 在 没有 配置 的 默认 情况 下 ，MyBatis 只 开启 一 
级 缓存 。 

MyBatis 的 缓存 模式 如 图 9-1 所 示 。 


仅 供 非 商业 用 途 或 交流 学 习 使 


非 卖 品 ， 仅 供 非 商业 用 途 或 交流 学 习 使 
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一 级 缓存 
(SqlSession1) 


一 级 缓存 
(SqlSession2) 


一 级 缓存 
(SqlSession2) 


二 级 缓存 
(Mapper) 


图 9-1 Mybatis 缓存 模式 


9.2 一 级 查询 缓存 


9.2.1 一 级 缓存 概述 


MyBatis 的 一 级 缓存 是 SqlSession 级 别 的 缓存 ， 在 操作 数据 库 时 需要 构造 SqlSession 对 象 。 
每 个 SqlSession 对 象 中 都 有 一 个 HashMap 对 象 用 于 缓存 数据 ， 不 同 的 SqlSession 之 间 的 缓存 数 
据 区 域 互 不 影响 。 

MyBatis 的 一 级 缓存 作用 域 是 SqlSession 范围 的 ， 在 参数 和 SQL 完全 一 样 的 情况 下 ， 使 用 
同一 个 SqlSession 对 象 调用 同一 个 Mapper 方 法 ， 往 往 只 执行 一 次 SQL， 因为 MyBatis 会 将 数据 
放 在 缓存 中 ， 下 次 查询 的 时 候 ， 如 果 没 有 声明 需要 刷新 缓存 并 且 缓存 没有 超时 ，SqlSession 都 
只 会 取出 当前 缓存 的 数据 ， 而 不 会 再 次 发 送 SQL 到 数据 库 中 。 需 要 注意 的 是 ， 如 果 SqlSession 
执行 了 DML 操作 (insert、update 和 delete) ， 并 提交 到 数据 库 ，MyBatis 会 清空 SqlSession 中 
的 一 级 缓存 ， 这 样 做 的 目的 是 为 了 保证 缓存 中 存储 的 是 最 新 的 信息 ， 以 避免 出 现 脏 读 现象 。 
MyBatis 的 缓存 机 制 是 基于 id 进行 缓存 的 ，MyBatis 使 用 HashMap 缓存 数据 时 ， 使 用 对 象 的 id 
作为 key， 而 对 象 则 作为 value 保存 。 


9.2.2 一 级 缓存 示例 
下 面 来 看 MyBatis 一 级 缓存 的 应 用 实例 ， 具 体 代 码 如 下 : 


@Resource 
private SqlSessionFactoryBean sqlSessionFactoryBean; 


@Test 
public void testSessionCache() throws Exceptiont{ 


仅 供 非 商业 用 途 或 交流 学 习 使 用 
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SqlSessionFactory sqlSessionFactory = 
sqlSessionFactoryBean.getObject ()，; 
SqlSession sqlSession = sqlSessionFactory.openSession(); 
AyUserDao ayUserDao = sqlSession.getMapper (AyUserDao.class); 
// 第 一 次 查询 
AyUser ayUser = ayUserDao.findById("1"); 
System.out .println("name: " + ayUser.getName() 
+ " password:" + ayUser.getPassword()); 

// 第 二 次 查询 
AyUser ayUser2 = ayUserDao.findById("1"); 
System.out.println("name: " + ayUser2.getName () 

+ " password:" + ayUser2.getPassword()); 
sqlSession.close();; 


} 


上 述 代码 中 ， 通 过 @Resource 注解 注入 SqlSessionFactoryBean 对 象 ，SqlSessionFactoryBean 
对 象 在 applicationContext.xml 配置 文件 中 己 配 置 ， 具 体 代 码 如 下 : 


<!--2. 数 据 源 druid --> 
<bean id="dataSource" class="com.alibaba.druid.pool.DruidDataSource" 
init-method="init" destroy-method="close"> 
<property name="driverClassName" value="${jdbc.driverClassName}" /> 
<property name="url" value="${jdbc.url}" /> 
<property name="username" value="$ {jdbc.username}" /> 
<property name="password" value="${jdbc.password}" /> 
</bean> 
<!--3、 配 置 SqlSessionFactory 对 象 --> 
<bean id="sqlSessionFactory" 
class="org.mybatis.spring.SqlSessionFactoryBean"> 
<!-- 注 入 数据 库 连 接 池 --> 
<property name="dataSource" ref="dataSource"/> 
<!-- 扫 描 sql 配置 文件 :mapper 需要 的 xml 文件 --> 
<property name="mapperLocations" value="classpath:mapper/*.xml"/> 
</bean> 


通过 SqlSessionFactory 工厂 获取 SqlSession 对 象 ， 通 过 SqlSession 对 象 的 getMapper() 方 法 
获取 AyUserDao 接口 对 象 ， 并 执行 AyUserDao 接口 对 象 的 findById0 方 法 。AyUserDao 和 
AyUserMapper.xml 的 代码 如 下 所 示 。 


QRepository 
public interface AyUserDao { 


仅 供 非 商业 用 途 或 交流 学 习 使 用 
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AyUser findqByIQ(String id) 


<select id="findById" parameterType="String" resultMap="userMap"> 
EC “ehROM ay Se 
WHERE id = #{id} 

</select> 


执行 测试 用 例 testSessionCache0， 控 制 台 打 印 相关 的 信息 ， 具 体 如 图 9-2 所 示 。 


hing JDBC Con from Datas 


ivy verification is not recommende 
nectionImpl879a1728c] will not bl 

437 DEBU 

:879 DEBUG 了 3 in 第 一 多 六 询 科 志 


:340 - Returning JDBC Connsction to DataSources 


9-2 ”控制 台 打 印 的 信息 


由 图 9-2 中 控制 台 打 印 的 信息 可 以 看 出 ， 第 一 次 查询 和 第 二 次 查询 ， 查 询 SQL 的 日 志 只 输 
出 一 遍 ， 这 就 说 明了 第 二 次 查询 的 数据 不 是 从 数据 库 查 询 出 来 的 ， 是 从 一 级 缓存 中 获取 的 。 
现在 在 两 次 查询 之 间 执 行 commit 操作 更新、 删除 或 者 插入 〉， 具 体 代码 如 下 所 示 : 


@Resource 
private SqlSessionFactoryBean sqlSessionFactoryBean; 


@Test 
public void testSessionCache() throws Exceptiont 
SqlSessionFactory sqlSessionFactory = 
sqlSessionFactoryBean.getObject () ， 
SqlSession sqlSession = sqlSessionFactory.openSession () ， 
AyUserDao ayUserDao = sqlSession.getMapper (AyUserDao.class); 


// 第 一 次 查询 
AyUser ayUser = ayUserDao.findById("1"); 
System.out.println("name: " + ayUser.getName () 


+ " password:" + ayUser.getPassword()); 


// 执 行 commit 操作 (如 更 新 、 插 入 、 删 除 等 操作 》 
AyUser user = new AyUser ();，; 
user.setId(1); 

user.setName ("al™"); 
ayUserDao.update (new AyUser () ) ; 
ayUserDao.update (ayUser); 


仅 供 非 商 业 用 途 或 交流 学 习 使 用 


非 卖 品 ， 仅 供 非 商业 用 途 或 交流 学 习 使 
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// 第 三 次 查询 
AyUser ayUser2 = ayUserDao.findById("1"); 
System.out .Println("name: " + ayUser2.getName () 

+ " password:" + ayUser2.getPassword()); 
sqlSession.close();; 


} 


执行 测试 用 例 testSessionCache()， 控 制 台 打印 相关 的 信息 ， 具 体 如 图 9-3 所 示 。 

由 图 9-3 控制 台 打 印 的 信息 可 以 看 出 ， 第 一 次 查询 和 第 二 次 查询 之 间 执 行 了 update 操作 ， 
update 操作 会 执行 commit， 也 就 是 说 会 清空 一 级 缓存 来 保证 数据 的 最 新 状态 ， 防 止 脏 读 情况 出 
现 。 因 此 第 一 次 查询 id 为 1 的 用 户 信息 时 ， 预 编译 了 SQL 语句， 数据 从 数据 库 中 查询 出 结果 ; 
第 二 次 查询 之 前 更 新 了 用 户 数 据 ， 并 执行 了 commit 方 法 提交 了 修改 ， 没 有 在 一 级 缓存 中 找到 id 
为 1 的 用 户 信息 ， 所 以 再 次 通过 数据 库 进 行 查询 。 


11:52:29, 402 DEBUG DataSourceUtils:114 - Fetching JDBC Connection from DataSource 


ST 2018 WARN: Establishing SS8L connection without server's OE verification is not recommer 


-~ ==> Preparing: SELECT * FROM ay user WHERE id=? 第 - 
- ==> Parameters: 1(String) 
9 - “== Total: 1 


==> Preparing: UPDATE ay user SET name = ?, password = ? WHERE id = ? 
1358 DEBUG update:1 ==> Parameters: ay(String), 123(String), 1i(Integer} 
1366 DEBUG update: <== Updates: 1 
==> Preparing: SELECT * FROM ay user WHERE id = ? 
ye - ==> Parameters: 1{String) 
5,871 DEBUG findById:159 - <== Total: 1 
ry password:123 


+872 DEBUG DataSourceUtils:340 - Returning JDBC Connection to DataSource 


图 9-3 控制 台 打 印 的 信息 


9.2.3 一 级 缓存 生命 周期 


MyBatis 在 开启 一 个 Session 会 话 时 ， 会 创建 一 个 新 的 SqlSession 对 象 ， 每 个 SqlSession 对 
象 会 创建 一 个 新 的 Executor 对 象 ，Executor 对 象 中 持 有 一 个 新 的 PerpetualCache 对 象 ， 当 会 话 结 
束 时 ，SqlSession 对 象 及 其 内 部 的 Executor 对 象 还 有 PerpetualCache 对 象 也 会 一 并 释放 掉 ， 即 : 


(1) 如 果 SqlSession 调用 了 close() 方 法 ， 会 释放 掉 一 级 缓存 PerpetualCache 对 象 ， 一 级 组 
存 不 可 用 。 

(2) 如 果 SqlSession 调用 了 clearCache()， 会 清空 PerpetualCache 对 象 中 的 数据 ， 但 是 该 对 
象 仍 可 使 用 。 

(3) SqlSession 中 执行 任何 一 个 DDL 操作 (update 、delete 、insert) ， 都 会 清空 
PerpetualCache 对 象 的 数据 ， 但 是 该 对 象 可 以 继续 使 用 。 


仅 供 非 商 业 用 途 或 交流 学 习 使 用 
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9.3 ”二 级 查询 缓存 


9.3.1 二 级 缓存 概述 


二 级 缓存 是 Mapper 级 别 的 缓存 。 使 用 二 级 缓存 时 ， 多 个 SqlSession 使 用 同一 个 Mapper 
(namespace) 的 SQL 语句 操作 数据 库 ， 得 到 的 数据 会 存在 二 级 缓存 区 域 , 二 级 缓存 同样 是 使 用 
HashMap 进行 数据 存储 。 二 级 缓存 比 一 级 缓存 作用 域 范 围 更 大 ， 多 个 SqlSession 可 以 共用 二 级 
缓存 ， 二 级 缓存 是 跨 SqlSession 的 。 当 某 个 SqlSession 类 的 实例 对 象 执行 了 增 、 删 、 改 等 操作 
时 ，Mapper 实例 会 清空 二 级 缓存 。MyBatis 默认 没有 开启 二 级 缓存 ， 需 要 在 配置 中 开启 二 级 组 
存 。 开 启 二 级 缓存 的 步骤 如 下 。 


首先 ， 在 applicationContext.xml 配置 文件 中 添加 如 下 配置 : 


<!--3、 配 置 SglSessionFactory 对 象 --> 
<bean id="sqlSessionFactory" 
class="org.mybatis.spring.SqlSessionFactoryBean"> 

<!-- 注 入 数据 库 连接 池 --> 

<property name="dataSource" ref="dataSource"/> 

<!-- 扫 描 sql 配置 文件 :mapper 需要 的 xml 文件 --> 

<property name="mapperLocations" value="classpath:mapper/*.xml"/> 

<!-- mybatis 配置 文件 的 位 置 --> 

<property name="configLocation" value="classpath: 

mybatis- config.xml"></property> 

</bean> 


上 面 配 置信 息 中 最 重要 的 就 是 指定 MyBatis 配置 文件 的 位 置 : 
<!-- mybatis 配置 文件 的 位 置 --> 


<property name="configLocation" 
value="classpath:mybatis-config.xml"></property> 


其 次 ， 在 srcvmainNesources 目录 下 添加 配置 文件 mybatis-config.xml， 具 体 代码 如 下 : 


<?xml Version="1.0" encoding="UTF-8" ?> 
<1DOCTYPE configuration 
PUBLIC "-//mybatis.org//DTD Config 3.0//EN" 
"http://mybatis.org/dtd/mybatis-3-config.dtd"> 
<configuration> 
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<!-- 全 局 配置 参数 ， 需 要 时 再 设置 --> 
<settings> 

<!-- 开启 二 级 缓存 ”默认 是 不 开启 的 --> 

<setting name="cacheEnabled" value="true"/> 
</settings> 


</configuration> 


最 后 ， 由 于 二 级 缓存 是 Mapper 级 别 的 ， 还 要 在 需要 开启 二 级 缓存 的 具体 mapper.xml 文件 
中 开启 二 级 缓存 ， 方 法 很 简单 ， 只 需要 在 mapper.xml 文件 中 添加 一 个 cache 标签 既 可 ， 有 具体 代 
码 如 下 所 示 : 


<1!-- 开启 AyUserMapper 的 namespace 下 的 二 级 缓存 --> 
<cache/> 


cache 标签 有 很 多 属性 ， 常 用 的 属性 如 表 9-1 所 示 。 
表 9-1 cache 标签 属性 


一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 


属性 名 称 描 ” 述 

收回 策略 ， 默 认为 LRU。 有 如 下 几 种 : 

。LRU (最 近 最 少 使 用 的 策略 )” 移 除 最 长 时 间 不 被 使 用 的 对 象 

eviction 。FIFO〈 先 进 先 出 策略 ) ” 按 对 象 进入 缓存 的 顺序 来 移 除 它们 

。SOFT 〈 软 引用 策略 ) ” 移 除 基于 垃圾 回收 器 状态 和 软 引 用 规则 的 对 象 
。WEAK ( 弱 引 用 策略 ) ”更 积极 地 移 除 基于 垃圾 收集 器 状态 和 弱 引 用 规则 的 对 象 
刷新 间隔 ， 可 以 被 设置 为 任意 的 正 整 数 ， 而 且 它 们 代表 一 个 合理 的 毫秒 形式 的 时 间 段 。 
默认 情况 是 不 设置 ， 也 就 是 没有 刷新 间隔 ， 绥 存 仅仅 调用 语句 时 刷新 

只 读 ， 属 性 可 以 被 设置 为 true 或 false。 只 读 的 缓存 会 给 所 有 调用 者 返回 缓存 对 象 的 相同 
readOnly 实例 ， 因 此 这 些 对 象 不 能 被 修改 。 这 提供 了 很 重要 的 性 能 优势 ， 可 读 写 的 缓存 会 返回 组 
存 对 象 的 拷贝 〈 通 过 序列 化 )。 这 会 慢 一 些 ， 但 是 安全 ， 因 此 默认 是 false 

缓存 数目 ， 可 以 被 设置 为 任意 正 整数 ， 要 记 住 你 缓存 的 对 象 数目 和 你 运行 环境 的 可 用 内 
存 资源 数目 。 默 认 值 是 1024 


flushInterval 


size 


9.3.2 ”二 级 缓存 示例 
下 面 来 看 MyBatis 二 级 缓存 的 应 用 实例 ， 具 体 代码 如 下 : 


Q@Resource 


private SqlSessionFactoryBean sqlSessionFactoryBean; 


@Test 
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public void testSessionCache() throws Exceptionl 
SqlSessionFactory sqlSessionFactory = 
sqlSessionFactoryBean.getObject () ; 
SqlSession sqlSession = sqlSessionFactory.openSession(); 
AyUserDao ayUserDao = sqlSession.getMapper (AyUserDao.class); 
// 第 一 次 查询 
AyUser ayUser = ayUserDao.findById ("1"); 
System.out.println("name: " + ayUser.getName () 
+ " password:'" + ayUser.getPassword()); 


// 执 行 commit 操作 (如 : 更 新 、 插 入 、 删 除 等 操作 ) 
AyUser user = new RAYUSer (); 
user.setld(1); 

user.setName ("al"); 

ayUserDao.update (new AyUser ()); 
ayUserDao.update (ayUser); 


// 第 二 次 查询 《命中 缓存 ) 
AyUser ayUser2 = ayUserDao.findById ("1"); 
System.out.printlin("name: " + ayUser2.getName () 

+t password:" + ayUser2.getPassword()); 
sqlSession.close();; 


} 
AyUserDao 和 AyUserMapper.xml 代码 如 下 : 
@Repository 


public interface AyUserDao { 


AyUser findById(string id); 


<select id="findById" parameterType="String" resultMap="userMap"> 
SELECT | FROM ay USer 
WHERE id = #{id} 

</select> 


当 开 启 MyBatis 二 级 缓存 后 ， 执 行 测试 用 例 testSessionCache()， 控 制 台 打印 相关 的 信息 ， 


具体 如 图 9-4 所 示 。 
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13:10:26, 514 DEBUG DataSourceUtils:114 - Fetching JDEC Connection Ercm DataSource 


Phu May 24 13:10:26 CST 2018 WARN: Establishing SSL connection without server's identity 
3:10:26,804 DEBUG SpringManagedTransaction:87 - JDBC Connection [com.mysql.cj.idbc.Co: 
:834 DEBUG findById:155 - ==> Preparing: SELECT * FROM ay Use WHERE id = ? 
13:10:27, 325 DEBUG findById:159 -~ ==> Parameters: 1 {String) 

13:10:27,671 DEBUG findById:159 - <== Votals 主 

name:; ay password;123 

:S18 DEBUG update:159 一 


verificatrion is not reco 
ctionImpl85ee34biib] will 


==> Ereparing: UPDATE ay user SET name = ?, password = 2? WHERE id = ? 


33:10;32,521 DEBUG update:159 - ==> Paramerers: ay{(String}, 123{(String}, i(Integer) 
:10:32,531 DEBUG update:159 - <== Updates: 1 
:10:33,785 DEBUG AyUserDao:é2 - Cache Hit Ratio [com.ay. dao.AyUserDao]: 0.0 
13:10:33,789 DEBUG findById:159 - ==> Preparing: SELECT * FROM ay user WHERE id = ? 
13:;10:33,752 DEBUG findById:159 - ==> Farameters; 1{String} 
13:10:33,801 DEBUG findById:159 - «== Total: 1 
name: ay Password:123 
13:10:41,048 DEBUG DataSourceUtils:340 - Returning JDBC Connection to DataSource 


图 9-4 控制 台 打 印 的 信息 


由 图 9-4 可 知 ， 第 一 次 查询 数据 时 ， 获 取 连 接 、 编 译 SQL、 加 载 了 数据 库 中 的 数据 。 而 第 
二 次 查询 数据 之 前 ， 进 行 了 update 操作 ， 相 当 于 进行 commit 操 作 ， 也 就 是 说 会 清空 一 级 缓存 来 
保证 数据 的 最 新 状态 。 但 是 开启 了 二 级 缓存 ， 在 第 二 次 查询 时 ， 会 从 二 级 缓存 中 获取 数据 。 

这 里 需要 注意 的 是 ， 如 果 在 select 标 签 中 设置 “userCache = false” 可 以 禁用 当前 select 语 句 
的 三 级 缓存 ， 具 体 代码 如 下 : 


<select id="findById" useCache="false" parameterType="String" 
resultMap="userMap"> 
SELECT * EROM ay USEL 
WHERE id = #{id} 
</select> 


这 里 简单 总 结 一 下 二 级 缓存 的 特点 : 


@ 缓存 是 以 namespace 为 单位 的 ， 不 同 的 namespace 下 的 操作 是 互 不 影响 的 。 
e 增删 改 查 操作 会 清空 namespace 下 的 全 部 缓存 。 


还 需要 注意 的 是 ， 使 用 二 级 缓存 需要 特别 谨慎 ， 有 时候 不 同 的 namespace 下 的 SQL 配置 可 
能 缓存 了 相同 的 数据 。 例 如 AyUserMapper.xml 中 有 很 多 查询 缓存 了 用 户 数据 ， 其 他 的 
XXXMapperxml 中 有 针对 用 户 表 进行 单 表 操作 ， 也 缓存 了 用 户 数据 ， 如 果 在 AyUserMapperxml 
中 做 了 刷新 缓存 的 操作 ， 在 XXXMapperxml 中 的 缓存 数据 仍然 有 效 ， 这 样 在 查询 数据 时 可 能 会 
出 现 脏 数据 。 所 以 使 用 MyBatis 的 二 级 缓存 时 ， 要 根据 具体 的 业务 情况 ， 谨 慎 使 用 。 


9.3.3 ”cache-ref 共享 缓存 


MyBatis 并 不 是 整个 Application 只 有 一 个 Cache 缓存 对 象 ， 它 将 缓存 划分 的 更 细 ， 也 就 是 
Mapper 级 别 的 ， 即 每 一 个 Mapper 都 可 以 拥有 一 个 Cache 对 象 ， 具 体 如 下 : 
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(1) 为 每 一 个 Mapper 分 配 一 个 Cache 缓存 对 象 〈 使 用 <cache> 节 点 配置 ) 。 
(2) 多 个 Mapper 共用 一 个 Cache 缓存 对 象 〈 使 用 <cache-ref> 节 点 配置 ) 。 


如 果 想 让 多 个 Mapper 共用 一 个 Cache， 可 以 使 用 <cache-ref namespace=""> 节 点 ， 来 指定 这 
个 Mapper 共享 哪 一 个 Mapper 的 Cache 缓存 。 具 体 如 图 9-5 所 示 。 


| Mapper namespace2 : 


9-5 控制 台 打 印 的 信息 


<cache-re 他 标签 使 用 实例 如 下 所 示 。 
UserMapper.xml 代码 如 下 : 


<?xml version="1.0'" encoding="UTF-8" ?> 
<!IDOCTYPE mapper PUBLIC "~//mybatis.org//DTD Mapper 3.0//EN" 
"http://mybatis.org/dtd/mybatis-3-mapper.dtd"> 
<mapper namespace="com.ay.dao.UserDao"> 
<! 一 非常 重要 --> 
<cache/> 
// 省 略 代码 


</mapper> 


MoodMapper.xml 代码 如 下 : 


<?xml] Version="1.0" encoding="UTF-8" ?> 
<!IDOCTYPE mapper PUBLIC "-//mybatis.org//DTD Mapper 3.0//EN" 
wnttp*//mybatis.org/Qtd/mybatis-3-mapper.dtd'"> 
<mapper namespace="com.ay.dao.MoodDao"> 
// 共 享 UserMapper 的 二 级 缓存 ， 要 求 UserMapper.xml 必须 有 <cache/> 标 签 
<cache-ref namespace="com.ay.dao.UserDao"/> 
// 省 略 代码 


</mapper> 
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9.4 MyBatis 缓存 原理 


9.4.1 MyBatis 缓存 的 工作 原理 


如 图 9-6 所 示 ， 一 个 SqlSession 对 象 中 创建 一 个 本 地 缓存 (local cache) ， 对 于 每 次 查询 ， 
都 会 根据 查询 条 件 去 一 级 缓存 中 查找 ， 如 果 缓 存 中 存在 数据 ， 就 直接 从 缓存 中 取出 ， 然 后 返回 
给 用 户 ; 否则 ， 从 数据 库 读 取 数 据 ， 将 查询 结果 存 入 缓存 并 返回 给 用 户 。 


用 户 请求 MyBatis 


一 级 缓存 


一 和 
2 


二 级 缓存 


图 9-6 MyBatis 一 级 缓存 机 制 


SqlSession 将 它 的 工作 交 给 了 Executor 执行 器 这 个 角色 来 完成 ， 负 责 完成 对 数据 库 的 各 种 
操作 。 当 创建 一 个 SqlSession 对 象 时 ，MyBatis 会 为 这 个 SqlSession 对 象 创建 一 个 新 的 Executor 
执行 器 ， 而 缓存 信息 就 被 维护 在 这 个 Executor 执行 器 中 ，MyBatis 将 缓存 和 对 缓存 相关 的 操作 
封装 成 了 Cache 接口 。 

如 图 9-7 所 示 ，MyBatis 的 二 级 缓存 机 制 的 关键 是 使 用 Executor 对 象 。 当 开启 SqlSession 会 
话 时 ， 一 个 SqlSession 对 象 使 用 一 个 Executor 对 象 来 完成 会 话 操 作 。 如 果 用 户 配 置 了 
"cacheEnabled=true"， 那 么 MyBatis 在 为 SqlSession 对 象 创 建 Executor 对 象 时 ， 会 对 Executor 对 
象 加 上 一 个 装饰 者 : CachingExecutor， 这 时 SqlSession 使 用 CachingExecutor 对 象 来 完成 操作 请 
求 。CachingExecutor 对 于 查询 请 求 ， 会 先 判 断 该 查询 请 求 在 二 级 缓存 中 是 否 有 缓存 结果 ， 如 果 
有 查询 结果 ， 则 直接 返回 缓存 结果 ; 如 果 缓 存 中 没有 ， 再 交 给 真正 的 Executor 对 象 来 完成 查询 
操作 ， 之 后 CachingExecutor 会 将 真正 Executor 返回 的 查询 结果 放置 到 缓存 中 ， 然 后 再 返回 给 
用 户 。 


和 
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用 户 请 求 
用 户 请 求 MyBatis 
FE 


Mapper 6 Mapper namespace2 . Mapper namespaceal 


Cache 
二 级 缕 存 


MemCache OSCache EHCache Redis 
图 9-7 MyBatis 二 级 缓存 机 制 


9.4.2 ”装饰 器 模式 


装饰 器 模式 (Decorator Pattern) 可 以 在 不 改变 一 个 对 象 本 身 功 能 的 基础 上 给 对 象 增加 额外 
的 功能 。 装 饰 器 模式 是 一 种 用 于 替代 继承 的 技术 ， 它 通过 一 种 无 须 定义 子 类 的 方式 来 给 对 象 动 
态 增 加 职责 ， 使 用 对 象 之 间 的 关联 关系 取代 类 之 间 的 继承 关系 。 在 装饰 器 模式 中 引入 了 装饰 
类 ， 在 装饰 类 中 既 可 以 调用 待 装饰 的 原 有 类 的 方法 ， 还 可 以 增加 新 的 方法 ， 以 扩充 原 有 类 的 
功能 。 
装饰 器 模式 动态 地 给 一 个 对 象 增加 一 些 额外 的 职责 ， 就 增加 对 象 功能 来 说 ， 装 饰 器 模式 比 
生成 子 类 实现 更 为 灵活 。 装 饰 器 模式 是 一 种 对 象 结构 型 模式 。 
在 装饰 模式 中 ， 为 了 让 系统 具有 更 好 的 灵活 性 和 可 扩展 性 ， 通 常会 定义 一 个 抽象 装饰 类 ， 
而 将 具体 的 装饰 类 作为 它 的 子 类 ， 装 饰 器 模式 的 结构 如 图 9-8 所 示 。 
在 装饰 器 模式 结构 图 中 包含 了 如 下 几 个 角色 : 
e Component (抽象 构件 ) : 它 是 具体 构件 和 抽象 装饰 类 的 共同 父 类 ， 声 明了 在 具体 构件 
中 实现 的 业务 方法 ， 它 的 引入 可 以 使 客户 端 以 一 致 的 方式 处 理 未 被 装饰 的 对 象 以 及 装 
饰 之 后 的 对 象 ， 实 现 客户 端的 透明 操作 。 
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Component 
Soharatoo 
pe 


元 
ConcreteComponent Decorator( 装 饰 喜 ) 


+operation() +Component component 
< X 
A 


洒 


过 


ConcreteDecoratori ConcreteDecorator2 
+operation(} +operation(} 


图 9-8 ”装饰 器 模式 结构 图 


e ConcreteComponent (具体 构件 ): ene Ont pe 用 于 定义 具体 的 构件 对 
象 ， 实 现 了 在 抽象 构件 中 声明 的 方法 ， 装 饰 器 可 以 给 它 增加 额外 的 职责 (方法) 。 
e Decorator (抽象 装饰 类 ) : 它 也 是 抽象 构件 类 的 子 类 ， 用 于 给 具体 构件 增加 职责 ， 但 
Re 它 维 护 一 个 指向 抽象 构件 对 象 的 引用 ， 通 过 该 引用 可 以 
装饰 之 前 构件 对 象 的 方法 ， 并 通过 其 子 类 扩展 该 方法 ， 以 达到 装饰 的 目的 。 
e ae (具体 装饰 类 ) : 它 是 抽象 装饰 类 的 子 类 ， 负 责 向 构件 添加 新 的 职 
责 。 每 一 个 具体 装饰 类 都 定义 了 一 些 新 的 行为 ， 它 可 以 调用 在 抽象 装饰 类 中 定义 的 方 
法 ， 并 可 以 增加 新 的 方法 用 以 扩充 对 象 的 行为 。 


由 于 具体 构件 类 和 装饰 类 都 实现 了 相同 的 抽象 构件 接口 ， 因 此 装饰 器 模式 以 对 客户 透明 的 
方式 动态 地 给 一 个 对 象 附加 上 更 多 的 责任 ， 换 言 之 ， 客 户 端 并 不 会 觉得 对 象 在 装饰 前 和 装饰 后 
有 什么 不 同 。 装 饰 器 模式 可 以 在 不 需要 创造 更 多 子 类 的 情况 下 ， 将 对 象 的 功能 加 以 扩展 。 

装饰 器 模式 的 核心 在 于 抽象 装饰 类 的 设计 ，Decorator 〈 装 饰 器 ) 的 典型 代码 如 下 所 示 ; 

class Decorator implements Component{ 

// 维 持 一 个 对 抽象 构件 对 象 的 引用 
private Component component; 
// 注 入 一 个 抽象 构件 类 型 的 对 象 


public Decorator (Component component) { 


this.component = component; 
} 
// 调 用 原 有 业务 方法 
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public void operation(){ 
component .operation(); 
} 

} 

在 抽象 装饰 类 Decorator 中 定义 Component 类 型 的 对 象 ， 维 持 一 个 对 抽象 构件 对 象 的 引用 ， 
并 可 以 通过 构造 方法 或 Setter 方法 将 一 个 Component 类 型 的 对 象 注 入 进来 ， 同 时 由 于 Decorator 
类 实现 了 抽象 构件 Component 接口 ， 因 此 需要 实现 在 其 中 声明 的 业务 方法 operation()。 需 要 注意 
的 是 ,在 Decorator 中 并 未 真正 实现 operation() 方 法 ， 而 只 是 调用 原 有 component 对 象 的 operation() 
方法 ， 它 没有 真正 实施 装饰 ， 而 是 提供 一 个 统一 的 接口 ， 将 具体 装饰 过 程 交 给 子 类 完成 。 

Decorator 的 子 类 即 具体 装饰 类 ConcreteDecorator 中 将 继承 operation() 方 法 并 根据 需要 进行 
扩展 ， 典 型 的 具体 装饰 类 代码 如 下 : 


class ConcreteDecorator extends Decoratort{ 


public ConcreteDecorator (Component component){ 
super (component); 
} 
public void operation()f{ 
// 调 用 原 有 业务 方法 
super.operation(); 
// 调 用 新 增 业 务 方法 
addedBehavior(); 


} 
// 新 增 业 务 方法 
public void addedBehavior(){ 


} 
! 


9.4.3 ”Cache 接口 及 其 实现 


Cache 接口 是 MyBatis 缓存 模块 中 最 核心 的 接口 ， 它 定义 了 所 有 缓存 的 基本 行为 。Cache 接 
口 的 具体 源码 如 下 所 示 : 
public interface Cache { 
// 该 缓存 对 象 的 iq 
Srnang geklow ， 
// 向 缓存 添加 数据 ， 一 般 情况 下 key 为 CacheKey，value 为 查询 结果 
void putObject (Object key, Object value); 


| 
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// 根 据 指定 的 key 在 缓存 中 查找 对 应 的 结果 对 象 
Object getObject (Object key); 

// 删 除 key 对 应 的 缓存 项 

Object removeObject (Object key); 

/ /清空 缓存 

void clear(); 

// 缓 存 项 个 数 

int getSize(); 

// 获 取 读 写 锁 

ReadWriteLock getReadWriteLock(); 


} 
Cache 接口 的 实现 类 有 很 多 ， 具 体 如 图 9-9 所 示 。 


Y SRcache 


Y Dhdecorators 
Gh BlockingCache 
Sh FifoCache 
LoggingCache 
GLruCache 
纺 ScheduledCache 
Sh SerializedCache 
Gh SoftCache 
Sh SynchronizedCache 
Sh TransactionalCache 
Sh WeakCache 

v Bimpl 
Sh PerpetualCache 


Cache 


图 9-9 ”Cache 接口 实现 类 


在 Cache 接口 的 实现 类 中 ， 大 部 分 都 是 装饰 器 ， 只 有 PerpetualCache 提供 了 Cache 接口 的 
基本 实现 。PerpetualCache 在 缓存 模块 中 扮演 着 ConcreteComponent (具体 构件 ) 的 和 角色， 底层 


使 用 HashMap 记录 缓存 项 ，PerpetualCache 具体 的 源码 如 下 : 


public class PerpetualCache implements Cache { 
private final String id; 
private Map<Object, Object> cache = new HashMap<Object, Object>(); 


public PerpetualCache (String id) {} 
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@Override 
Eublie String getId() {} 


QOverride 
public int getsize() {} 


@Override 
Public void putObject (Object key, Object value) {} 


QOverride 
public Object getObject (Object key) {} 


@Override 
public Object removeObject (Object key) {} 


QOverride 
public void clear() {} 


@Override 
public ReadWriteLock getReadWriteLock() {} 


} 

除了 PerpetualCache 缓存 类 外 ，Cache 接口 的 其 他 实现 类 都 是 装饰 器 ， 这 些 装饰 器 扮演 着 
ConcreteDecorator 的 角色 并 在 PerpetualCache 的 基础 上 提供 额外 的 功能 ， 通 过 多 个 组 合 后 满足 一 
个 特定 的 需求 。 其 他 装饰 器 和 Cache 的 类 结构 如 图 9-10 所 示 。 


i cache | 
a 和 和 
a rm 证 渍 esans 
一 一 i 1 
me { 1! 1 
e perpetualCache | 2 Fifocache | © % SynchronizedCache | c BlockingCache 


4 


图 9-10 “Cache 接口 实现 类 


这 里 就 不 再 继续 剖析 每 个 装饰 器 缓存 类 的 源码 ， 感 兴趣 的 读者 可 以 自己 查看 MyBatis 相关 
源码 进行 学 习 。 


仅 供 非 商业 用 途 或 交流 学 习 使 


< 


非 卖 品 ， 仅 供 非 商业 用 途 或 交流 学 习 使 


Spring MVC 原理 剖析 


本 章 主要 介绍 Spring MVC 执行 流程 的 原理 、 前 端 控 制 器 DispatcherServlet 的 原理 、 处 理 映 
射 器 和 处 理 适 配器 的 原理 以 及 视图 解析 器 的 原理 等 。 


10.1 Spring MVC 执行 流程 


10.1.1 Spring MVC 执行 流程 


Spring MVC 框架 整体 的 请 求 流程 如 图 10-1 所 示 ， 该 图 显示 了 用 户 从 请 求 到 响应 的 完整 
流程 。 

《1) 用 户 发 起 request 请 求 ， 该 请 求 被 前 端 控制 器 (DispatcherServlet〉 处 理 。 

(2) 前 端 控制 器 (DispatcherServlet) 请 求 处 理 映 射 器 (HandlerMapping) 查找 Handler。 

(3) 处 理 上 映射 器 (HandlerMapping) 根据 配置 查找 相关 的 Handler， 返 回 给 前 端 控制 器 
(DispatcherServlet) 。 

(4) 前 端 控制 器 (DispatcherServlet) 请 求 处 理 适 配器 (HandlerAdapter) 执行 相应 的 Handler 
(或 称 为 Controller) 。 

(5) 处 理 适配器 (HandlerAdapter) 执行 Handler。 

(6) Handler 执行 完毕 后 会 返回 ModelAndView 对 象 给 HandlerAdapter。 


‘ 
仅 供 非 商 业 用 途 或 交流 学 习 使 / 一 
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图 10-1 Spring MVC 框架 整体 的 请 求 流程 


(7) HandlerAdapter 对 象 接 收 到 Handler 返回 的 ModelAndView 对 象 后 ， 将 其 返回 给 前 端 
控制 器 (DispatcherServlet) 。 

(8) 前 端 控制 器 (DispatcherServlet) 接 收 到 ModelAndView 对 象 后， 请求 视 图 解析 器 (View 
Resolver) 对 视图 进行 解析 。 

(9) 视图 解析 器 (View Resolver) 根据 View 信息 匹配 相应 的 视图 结果 ， 返 回 给 前 端 控制 
器 (DispatcherServlet) 

(10) 前 端 控制 器 〈DispatcherServlet) 收 到 View 视图 后 ， 对 视图 进行 泻 染 ， 将 Model 中 
的 模型 数据 填充 到 View 视图 中 的 request 域 ， 生 成 最 终 的 视图 。 

(11) 前端 控制 器 (DispatcherServlet〉 返回 请 求 结果 给 用 户 。 


处 理 适 配器 (HandlerAdapter) 执行 Handler (或 称 为 Controller) 的 过 程 中 ，Spring 还 做 了 
一 些 额外 的 工作 ， 有 具体 如 图 10-2 所 示 。 

e HttpMessageConverter (消息 转换 ) : 将 请 求 信 息 ， 比 如 : JSON、XML 等 数据 转换 成 
一 个 对 象 ， 并 将 对 象 转换 为 指定 的 响应 信息 。 

e ”数据 转换 : 对 请 求 的 信息 进行 转换 ， 比 如 ，String 转 换 为 Integer、Double 等 。 

e 数据 格式 化 : 对 请 求 消息 进行 数据 格式 化 ， 比 如 字符 串 转换 为 格式 化 数据 或 者 格式 化 
日 期 等 。 

e 数据 验证 : 验证 请 求 数据 的 有 效 性 ， 并 将 验证 的 结果 存储 到 BindingResult 或 Error 中 。 


仅 供 非 商业 用 途 或 交流 学 习 使 
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图 10-2 数据 转换 、 格 式 化 、 校 验 


以 上 就 是 Sring MVC 请 求 到 响应 的 整个 工作 流程 ， 中 间 使 用 到 的 组 件 有 前 端 控制 器 
(DispatcherServlet) 、 处 理 映 射 器 (HandlerMapping) 、 处 理 适 配器 (HandlerAdapter) 、 处 理 
器 (Handler) 、 视 图 解析 器 (View Resolver) 和 视图 (View) 等 。 各 个 组 件 的 功能 ， 会 在 后 续 


章节 简单 介绍 。 


10.1.2 ”前 端 控制 器 DispatcherServlet 


前 端 控制 器 DispatcherServlet 的 作用 就 是 接受 用 户 请 求 ， 然 后 给 用 户 响 应 结果 。 它 的 作用 
相当 于 一 个 转发 器 或 中 央 处 理 器 ， 控 制 整个 流程 的 执行 ， 对 各 个 组 件 进行 统一 调度 ， 


件 之 间 的 耦合 性 ， 有 利于 组 件 之 间 的 扩展 。 
DispatcherServlet 部 分 的 源码 如 下 所 示 : 


public class DispatcherServVlet extends ERrameworkServlet { 


private LocaleResolver localeResolver; 


private ThemeResolver themeResolver; 


private List<HandlerMapping> handlerMappings; 
private List<HandlerAdapter> handlerAdapters; 


以 降低 组 


private List<HandlerExceptionResolver> handlerExceptionResolvers; 
private RequestToViewNameTranslator viewNameTranslator; 


private FlashMapManager flashMapManager; 


private List<ViewResolver> viewResolvers; 


// 省 略 代码 


仅 供 非 商 业 用 途 或 交流 学 习 使 
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protected void initStrategies (ApplicationContext context) { 
initMultipartResolver (context); 
initLocaleResolver (context); 
initThemeResolver (Context) ， 
initHandlerMappings (context); 
initHandlerAdapters (context); 
initHandlerExceptionResolvers (context); 
initRequestToViewNameTranslator (context); 
initViewResolvers (context); 
initFlashMapManager (context); 


} 
DispatcherServlet 类 的 类 继承 结构 如 图 10-3 所 示 。 


Ds ServletConfig B % Serializable 六 Serviet 


蕊 GenericServlet 


六 EnvironmentCapable | © % HttpServiet 


© ~ HttpServletBean ; 


| 


© FrameworkServlet 


© » DispatcherServlet 


图 10-3 ”DispatcherServlet 的 类 结构 


由 图 10-3 可 知 ，DispatcherServlet 最 上 层 的 父 类 是 Servlet 类 ， 也 就 是 说 DispatcherServlet 
也 是 一 个 Servlet， 且 包含 有 deGet() 和 doPost() 方 法 。initStrategies 方法 在 WebApplicationContext 
初始 化 后 自动 执行 ， 自 动 扫 描 上 下 文 的 Bean， 根 据 名 称 或 者 类 型 匹配 的 机 制 查找 自 定义 的 组 件 ， 
如 果 没 有 找到 ， 会 装配 Spring 的 默认 组 件 。Spring 的 默认 组 件 在 org.springframework.web.servlet 路 
径 下 的 DispatcherServlet.properties 配置 文件 中 配置 。DispatcherServlet.properties 的 具体 代码 如 下 : 
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# Default implementation classes for DispatcherServlet's strategy 
interfaces. 
# Used as fallback when no matching beans are found in the DispatcherServlet 
context. 
# Not meant to be customized by application developers. 
// 本 地 化 解析 器 
org.springframework.web.servlet.LocaleResolver=org.springframework.web.s 
ervlet.il8n.AcceptHeaderLocaleResolver 
// 主 题解 析 器 
org.springframework.web.servilet.ThemeResolver=org.springframework.web.se 
rvlet.theme.FixedThemeResolver 
// 处 理 映射 器 
org.springframework.web.servlet.HandlerMapping=org.springframework.web.s 
erviet.handler.BeanNameUrlHandlerMapping,\ 
org.springframework.web.servlet.mvce.method.annotation.RequestMappingHand 
lerMapping 
// 处 理 适 配器 
org.springframework.web.servlet.HandlerAdapter=org.springframework.web.s 
ervlet.mvce.HttpRequestHandlerAdapter,\ 
org.springframework.web.servlet.mvce.SimpleControllerHandlerAdapter,\ 
org.springframework.web.servlet.mvce.method.annotation.RequestMapping 
HandlerAdapter 
// 有 异常 处 理 器 
org.springframework.web.servlet.HandlerExceptionResolver=org.springframe 
work.web.servilet.mvc.method.annotation.ExceptionHandlerExceptionResolver,\ 
org.springframework.web.servlet.mvc.annotation.ResponseStatusExcepti 
onResolver,\ 
org.springframework.web.servlet.mvc.support.DefaultHandlerExceptionR 
esOLlVer 
// 视 图 名 称 解析 器 
org.springframework.web.servlet.RequestToViewNameTranslator=org.springfr 
amework.web.serviet.view.DefaultRequestToViewNameTranslator 
// 视 图 解析 器 
org.springframework.web.servlet.ViewResolver=org.springframework.web.ser 
vlet.view.InternalResourceViewResolver 
//FlashMap 映射 管理 器 
org.springframework.web.servlet,.FlashMapManager=org.springframework.web. 
servilet.support.SessionFlashMapManager 
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DispatcherServlet 类 包含 许多 方法 ， 大 致 可 以 分 为 以 下 三 类 : 
(1) 初始 化 相关 处 理 类 的 方法 ， 比 如 initMultipartResolver()、initLocaleResolver() 等 。 
(2) 响应 HTTP 请 求 的 方法 。 
(3) 执行 处 理 请 求 逻辑 的 方法 。 

DispatcherServlet 装配 的 组 件 ， 上 有 具体 内容 如 下 所 示 : 


e 本 地 化 解析 器 (LocaleResolver) : 本 地 化 解析 ， 只 允许 一 个 实例 。 因 为 Spring 支 持 国 
际 化 ， 所 以 LocalResover 解 析 客 户 端的 Locale 信 息 从 而 方便 进行 国际 化 。 如 果 没 有 找 
到 ， 使 用 默认 的 实现 类 AcceptHeaderLocaleResolver 作 为 该 类 型 的 组 件 。 

e 主题 解析 器 (ThemeResovler) : 主题 解析 ， 只 允许 一 个 实例 。 通 过 它 来 实现 一 个 页 面 
多 大 风格 ， 即 常见 的 类 似 于 软件 皮肤 效果 。 如 果 没 有 找到 ， 使 用 默认 的 实现 类 
FixedThemeResolver 作 为 该 类 型 的 组 件 。 

e 处理 映射 器 (HandlerMapping) : 请 求 到 处 理 器 的 映射 ， 允 许多 个 实例 。 如 果 映 射 成 功 返 回 
一 个 HandlerExecutionChain 对 象 (包含 一 个 Handler 处 理 器 [页 面 控制 器 ] ) 对 象 、 多 个 
HandlerInterceptor 拦 截 器 ) 对 象 ; 如 果 detectHandlerMappings 的 属性 为 true (默认 为 true ) ， 则 
根据 类 型 匹配 机 制 查找 上 下 文 及 Spring 容器 中 所 有 类 型 为 HandlerMapping 的 Bean， 将 它们 作 
为 该 类 型 的 组 件 。 如 果 detectHandlerMappings 的 属性 为 false， 则 查找 名 为 handlerMapping、 类 
型 为 HandlerMapping 的 Bean 作 为 该 类 型 组 件 。 如 果 以 上 两 种 方式 都 没有 找到 ， 则 使 用 
BeanNameUrlHandlerMapping 实现 类 创建 该 类 型 的 组 件 。BeanNameUrlHandlerMapping 将 
URL 与 Bean 名 字 映 射 ， 映 射 成 功 的 Bean 就 是 此 处 的 处 理 器 。 

e 处理 适配器 (HandlerAdapter) : 允许 多 个 实例 ，HandlerAdapter 将 会 把 处 理 器 包装 为 
适配器 ， 从 而 支持 多 种 类 型 的 处 理 器 ， 即 适配器 设计 模式 的 应 用 ， 从 而 很 容易 支持 很 
多 类 型 的 处 理 器 。 如 SimpleControllerHandlerAdapter 将 对 实现 了 Controller 接 只 的 Bean 进 
行 适 配 ， 并 且 按 处 理 器 的 handleRequest 方 法 进行 功能 处 理 。 默 认 使 用 
DispatcherServlet.properties 配 置 文件 中 指定 的 三 个 实现 类 分 别 创 建 一 个 适配器 ， 并 将 其 
添加 到 适配器 列表 中 。 

e@ 处理 异常 解析 器 (HandlerExceptionResolver) : 允许 多 个 实例 。 处 理 器 异常 解析 可 以 
将 异常 映射 到 相应 的 统一 错误 界面 ， 从 而 显示 用 户 友好 的 界面 ( 而 不 是 给 用 户 看 到 具体 
的 错误 信息 ) 。 默 认 使 用 DispatcherServlet.properties 配 置 文件 中 定义 的 实现 类 。 

e 视图 名 称 解析 器 (ViewNameTranslator) : 只 允许 一 个 实例 。 默 认 使 用 
DefaultRequestToViewNameTranslator 作 为 该 类 型 的 组 件 。 

e 视图 解析 器 (ViewResolver) : 允许 多 个 实例 。ViewResolver 将 把 逻辑 视图 名 解析 为 具 
体 的 View ， 通 过 这 种 策略 模式 ， 很 容易 更 换 其 他 视图 技术 ， 如 
InternalResourceViewResolver 将 逻辑 视图 名 映射 为 JSP 视 图 。 


仅 供 非 商业 用 途 或 交流 学 习 使 


非 卖 品 ， 仅 供 非 商业 用 途 或 交流 学 习 使 


182 | Spring MVC + MyBatis 快速 开发 与 项 目 实战 


e FlashMap 了 映射 管理 器 : 查找 名 为 FlashMapManager、 类 型 为 SessionFlashMapManager 的 
bean 作 为 该 类 型 组 件 ， 用 于 管理 FlashMap， 即 数据 默认 存储 在 HttpSession 中 。 


需要 注意 的 是 ，DispatcherServlet 装配 的 各 种 组 件 ， 有 些 只 允许 一 个 实例 ， 有 些 则 允许 多 


个 实例 。 如 果 同 一 个 类 型 的 组 件 存在 多 个 ， 可 以 通过 Order 属性 确定 优先 级 的 顺序 ， 值 越 小 的 
优先 级 越 高 。 


10.2 ”处 理 映 射 器 和 适配器 


10.2.1 ”处 理 映射 器 


处 理 映 射 器 HandlerMapping 是 指 请 求 到 处 理 器 的 映射 时 ， 人 允许 有 多 个 实例 。 如 果 映 射 成 功 
返回 一 个 HandlerExecutionChain 对 象 〈( 包 含 一 个 Handler 处 理 器 [页 面 控制 器 ] 对 象 、 多 个 
HandlerInterceptor 拦截 器 ) 对象 。Spring MVC 提供 了 多 个 处 理 映 射 器 HandlerMapping 实现 类 ， 
下 面 分 别 进行 说 明 。 

1. BeanNameUrlHandlerMapping 


BeanNameUrlHandlerMapping 是 默认 映射 器 ， 在 不 配置 的 情况 下 ， 默 认 就 使 用 这 个 类 来 映 
射 请 求 。 其 映射 规则 是 根据 请 求 的 URL 与 Spring 容器 中 定义 的 处 理 器 bean 的 name 属性 值 进行 
匹配 ， 从 而 在 Spring 容器 中 找到 Handler 〈 处 理 器 ) 的 bean 实例 。 


// 默 认 映 射 器 ， 在 不 配置 的 情况 下 ， 默 认 就 使 用 这 个 来 映射 请 求 。 
<bean class="org.springframework.web.servilet. 
handler.BeanNameUrlHandlerMapping"></bean> 

// 映 射 器 把 请 求 映 射 到 controller 


<beanid="testController" name="/hello.do" 
class="cn.itcast.controller.TestController"></bean> 


2. SimpleUrlHandlerMapping 


SimpleUrlHandlerMapping 根据 浏览 器 URL 匹配 prop 标签 中 的 key， 通 过 key 找到 对 应 的 
Controller。 


<bean class="org.springframework.web.servilet.handler. 
SimpleUrlHandlerMapping"> 
<property name="mappings"> 
<props> 
<prop key="/hello.do">testController</prop> 
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<prop key="/test.do">testController</prop> 
</props> 
</property> 
</bean> 
<bean id="testController" 


name="/hello.do" class="cn.itcast.controller.TestController"></bean> 


上 述 配 置 了 两 个 不 同 的 URL 映射 ， 对 应 于 同一 个 Controller 配置 。 也 就 是 说 ， 在 浏览 器 中 
发 起 两 个 不 同 的 URL 请 求 ， 会 得 到 相同 的 处 理 结果 。 


10.2.2 ”处 理 适 配器 


处 理 适配器 (HandlerAdapter) 人 允许 多 个 实例 ，HandlerAdapter 将 会 把 处 理 器 包装 为 适配器 ， 
从 而 支持 多 种 类 型 的 处 理 器 ， 即 适配器 设计 模式 的 应 用 ， 从 而 很 容易 支持 多 种 类 型 的 处 理 器 。 
如 SimpleControllerHandlerAdapter 将 对 实现 了 Controller 接口 的 Bean 进行 适 配 ， 并 且 按 处 理 器 
的 handleRequest 方法 进行 功能 处 理 。 默 认 使 用 DispatcherServlet.properties 配置 文件 中 指定 的 三 
个 实现 类 分 别 创建 一 个 适配器 ， 并 将 其 添加 到 适配器 列表 中 。 

Spring MVC 提供 了 多 个 处 理 适 配器 〈HandlerAdapter) 实现 类 ， 分 别 说 明 如 下 。 


1. SimpleControllerHandlerAdapter 


SimpleControllerHandlerAdapter 支持 所 有 实现 Controller 接口 的 Handler 控制 器 ， 是 
Controller 实现 类 的 适配器 类 ， 其 本 质 是 执行 Controller 类 中 的 handleRequest 方法 。 
SimpleControllerHandlerAdapter 的 源码 如 下 : 


public class SimpleControllerHandlerAdapter implements HandlerAdapter { 


@Override 

public boolean supports(Object handler) { 
// 判 断 是 否 实 现 Controller 接口 
return (handler instanceof Controller); 


} 


@Override 

@Nullable 

public ModelAndView handle (HttpServletRequest request, 

HttpServletResponse response, Object handler) throws Exception { 
// 将 handler 强制 转换 为 Controller， 并 调用 handleRegquest 方法 


return ((Controller) handler) .handleRequest (request, response); 
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QOverride 
public long getLastModified(HttpServletRequest request, 
Object handler) { 
if (handler instanceof LastModified) { 
return ((LastModified) handler) .getLastModified (request); 
} 
Gu — 1l> 


} 
Controller 接口 的 定义 也 很 简单 ， 仅 仅 定 义 了 一 个 handleRequest 方法 ， 具 体 源码 如 下 : 


QFEunctionalInterface 
public interface Controller { 
@Nullable 
ModelAndView handleRequest (HttpServletRequest request, 
HttpServletResponse response) throws Exception; 


} 
2. HttpRequestHandlerAdapter 


HttpRequestHandlerAdapter 本 质 是 调用 HttpRequestHandler 的 handleRequest 方法 ， 请 看 下 
述 代码 示例 : 


public class HttpRequestHandlerAdapter implements HandlerAdapter { 
QOverride 
public boolean supports (Object handler) { 
// 判 断 是 否 是 HttpRequestHandler 类 型 
return (handler instanceof HttpRequestHandler); 


@Override 

@Nullable 

public ModelAndView handle (HttpServletRequest redquest， 

HttpServletResponse response, Object handler) throws Exception { 
// 执 行 HttpRequestHandler 的 handleRequest 方法 
((HttpRequestHandler) handler) .handleReduest (request, 

response); 

return null; 

} 

@Override 

public long getLastModified (HttpServletRequest request, Object 

handler) 1{ 
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// 返 回 modified 值 
if (handler instanceof LastModified) { 
return ((LastModified) handler) .getLastModified (request); 
} 


returne =1L; 


} 


HttpRequestHandlerAdapter 本 质 是 HttpRequestHandler 的 适配器 ， 最 终 调用 
HttpRequestHandler 的 handleRequest 方法 。 接 口 HttpRequestHandler 的 实现 如 下 : 


@FunctionalInterface 
public interface HttpRequestHandler { 
oid handleRequest (HttpServiletRequest request, HttpServletResponse 
response) throws ServletException, IOException; 
} 


3. RequestMappingHandlerAdapter 


RequestMappingHandlerAdapter 其 父 类 是 AbstractHandlerMethodAdapter 抽象 类 ， 
AbstractHandlerMethodAdapter 只 是 简单 地 实现 了 HandlerAdapter 中 定义 的 接口 ， 最 终 还 是 在 
RequesrMappingHandlerAdapter 中 对 代码 进行 实现 的 ，AbstractHandlerMethodAdapter 中 增加 了 
执行 顺序 Order， 有 具体 如 图 10-4 所 示 。 


下 AppicationContextAware | 
0 2 


’ ServiletContextAware | 5 ApplicationObjectSupport 


5 WebApplicationObjectSdupport 


| 


5 WebContentGenerator 3% Ordered Bs HandlerAdapter 
. wo ww mm mn mw wm A 
| 
5 AbstractHandlerMethodAdapter 间 = InitializingBean | 


Ce 


全 RequestMappingHandlerAdapter ， 


图 10-4 RequestMappingHandlerAdapter 类 继承 关系 
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AbstractHandlerMethodAdapter 的 源码 如 下 : 


public abstract class AbstractHandlerMethodAdapter 
extends WebContentGenerator implements HandlerAdapter, Ordered { 
private int order = Ordered.LOWEST PRECEDENCE; 
public AbstractHandlerMethodAdapter() { 
// no restriction of HTTP methods by default 
super (false); 
} 
public void setOrder(int order) { 
this.order = order; 


public int getOrder() { 
return this.order; 


public final boolean supports (Object handler) { 
return (handler instanceof HandlerMethod && 
supportsIinternal((HandlerMethod) handler)); 
;) 
protected abstract boolean supportsInternal (HandlerMethod 
handlerMethod); 


public final ModelAndView handle (HttpServletRequest request, 

HttpServletResponse response, Object handler) throws Exception { 
return handleInternal (request, response, (HandlerMethod) 
handler); 

} 

// 未 实现 的 抽象 方法 

protected abstract ModelAndView handleInternal (HttpServletRequest 

request, HttpServletResponse response, HandlerMethod handlerMethod) 

throws Exception; 


public final long getLastModified(HttpServletRequest request, 
Object handler) { 
return getLastModifiedIinternal (request, (HandlerMethod) 
handler); 
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// 未 实现 的 抽象 方法 
protected abstract long getLastModifiedInternal (HttpServletRequest 


request, HandlerMethod handlerMethod); 
} 


RequestMappingHandlerAdapter 实现 AbstractHandlerMethodAdapter 类 ， 真 正 意义 上 实现 了 
HandlerAdapter 的 功能 。RequestMappingHandlerAdapter 的 部 分 源码 如 下 : 


public class RequestMappingHandlerAdapter extends 
AbstractHandlerMethodAdapter 
implements BeanFactoryAware, InitializingBean { 
// 默 认 返 回 true 
protected boolean supportsInternal (HandlerMethod handlerMethod) { 
return true; 
} 
// 默 认 返 回 -1 
protected long getLastModifiedIinternal (HttpServiletRequest request, 
HandlerMethod handlerMethod) { 


return -1; 


0 
protected ModelAndView handleInternal (HttpServletRequest request, 
HttpServletResponse response, HandlerMethod handilerMethod) throws 
Exception { 
ModelAndView mav; 
// 检 查 request 请 求 方法 method 是 否 支 持 
checkRequest (request); 
//Execute invokeHandlerMethod in synchronized block if required. 
// 判 断 是 否 需 要 在 synchronize 块 中 执行 
if (this.synchronizeOnSession) { 
HttpSession session = request.getSession (false); 
if (session != null) { 
Object mutex = WebUtils.getSessionMutex (session); 
synchronized (mutex) | 
mav = invokeHandlerMethod (request, response, 
handlerMethod); 


} 
else { 


// No HttpSession available -> no mutex necessary 


mav = invokeHandlerMethod (request, response, 


| 
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handlerMethod); 


} 
else { 
// No synchronization on session demanded at all... 
mav = invokeHandlerMethod (request, response, 
handlerMethod); 
} 
// 省 略 代码 


return mav; 


} 


从 上 述 代 码 可 知 ，RequestMappingHandlerAdapter 的 处 理 逻 辑 主要 由 handleInternal() 实 现 ， 
而 核心 处 理 逻 辑 由 方法 invokeHandlerMethod() 实 现 ，invokeHandlerMethod 方法 具体 源码 如 下 : 


// 调 用 处 理 器 方法 ， 即 要 执行 的 Controller 中 的 具体 的 方法 
protected ModelAndView invokeHandlerMethod (HttpServletRequest redquest， 
HttpServietResponse response, HandlerMethod handlerMethod) 
throws Exception { 
ServletWebRequest webRequest = new ServletWebRequest (request, response); 
try { 
// 绑 定数 据 
WebDataBinderFactory binderFactory = 
getDataBinderFactory (handlerMethod); 
ModelFactory modelFactory = getModelFactory (handlerMethod, 
binderFactory); 
ServletInvocableHandlerMethod invocableMethod = 
createInvocableHandlerMethod (handlerMethod); 
if (this.argumentResolvers != null) { 
invocableMethod.setHandlerMethodArgumentResolvers 
(this.argumentResolvers); 
} 
if (this.returnValueHandlers != null) { 
invocableMethod.setHandlerMethodReturnValueHandlers 
(this.returnValueHandlers); 
} 
invocableMethod.setDataBinderFactory (binderFactory); 
invocableMethod.setParameterNameDiscoverer 
(this.parameterNameDiscoverer); 
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// 创 建 ModelAndView 容器 
ModelAndViewContainer mavContainer = new 
ModelAndViewContainer (); 
mavContainer.addAllAttributes 
(RequestContextUtils.getInputFlashMap (request)); 
// 初 始 化 model 
modelFactory.initModel (webRequest, mavContainer, invocableMethod); 
mavContainer.setIlgnoreDefaultModelOnRedirect 
(this.ignoreDefaultModelOnRedirect); 
AsyncWebRequest asyncWebRequest = 
WebAsyncUtils.createAsyncWebRequest (request, response); 
asyncWebRequest.setTimeout (this.asyncRequestTimeout); 
WebAsyncManager asyncManager = 
WebAsyncUtils.getAsyncManager (request); 
asyncManager.setTaskExecutor (this.taskExecutor),; 
asyncManager.setAsyncWebRequest (asyncWebRequest); 
asyncManager.registerCallableInterceptors 
(this.callableInterceptors); 
asyncManager.registerDeferredResultInterceptors 
(this.deferredResultIinterceptors); 
if (asyncManager.hasConcurrentResult()) { 
Object result = asyncManager.getConcurrentResult (); 
mavContainer = (ModelAndViewContainer) 
asyncManager.getConcurrentResultContext () [0]; 
asyncManager.clearConcurrentResult () ， 
if (logger.isDebugEnabled()) { 
logger.debug ("Found concurrent result value 
Bae eS ul Et tl a 
} 
invocableMethod = invocableMethod. 
wrapConcurrentResult (result); 
} : 
// 执 行 处 理 器 的 方法 
invocableMethod.invokeAndHandle (webRequest, mavContainer); 
if (asyncManager.isConcurrentHandlingstarted()) { 
return null; 
} 
// 返 回 ModelAndView 
return getModelAndView (mavContainer, modelFactory, webRequest); 
}finally { 
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webRequest.requestCompleted (); 


} 


从 上 述 代 码 可 知 ，RequestMappingHandlerAdapter 内 部 对 于 每 个 请 求 都 会 实例 化 一 个 
ServletInvocableHandlerMethod ( InvocableHandlerMethod 的 子 类 ) 进行 处 理 。 
ServletInvocableHandlerMethod 类 继承 关系 如 图 10-5 所 示 。 


@ % HandlerMethod | 


| 


c InvocableHandlerMethod | 


| 


图 10-5 ”ServletInvocableHandlerMethod 类 继承 关系 


InvocableHadlerMethod 类 通过 调用 getMethodArgumentValues() 获 取 方 法 的 输入 参数 ， 具 体 
源码 如 下 : 


private Object[] getMethodArgumentValues (NativeWebRequest request, 
@Nullable ModelAndViewContainer mavContainer, 
Object... providedArgs) throws Exception { 
MethodParameter[] parameters = this.getMethodParameters () ， 
Object[] args = new Object[parameters.length]; 
for(int i = 0; i < parameters.length; ++i) { 
MethodParameter parameter = parameters[i]; 
parameter.initParameterNameDiscovery 
(this.parameterNameDiscoverer); 
args[i] = this.resolveProvidedArgument (parameter, providedArgs); 
if (args[i] == null) { 
// 获 取 能 够 处 理 入 参 的 ArgumentResolver， 然 后 解析 参数 
if (this.argumentResolvers.supportsParameter (parameter)) 1 
Cy 
args[i] = this.argumentResolvers.resolveArgument (parameter, 
mavContainer, request, this.dataBinderFactory); 
} catch (Exception var9) { 
if (this.logger.isDebugEnabled()) { 


和 从 
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this.logger.debug 
(this.getArgumentResolutionErrorMessage 
("Failed to resolve", i), var9); 
} 
throw var9; 
} 
} else if (args[i] == null) { 
throw new IllegalStateException("Could not resolve method 
parameter at index " + parameter.getParameterIindex() + " in" 
+ parameter.getExecutable() .toGenericSstring() + ": " 
+this.getArgumentResolutionErrorMessage ("No suitable 
TeSOlVer ROOTE I) 


} 


return args; 


} 


从 上 述 代码 可 知 ， 解 析 参 数 的 方式 和 handlerMappings、handlerAdapters 类 似 ， 都 是 从 一 个 
HandlerMethodArgumentResolver 列表 中 遍历 ， 找 到 一 个 能 够 处 理 的 bean， 然 后 调用 bean 的 核心 
方法 处 理 。HandlerMethodArgumentResolver 接口 的 定义 如 下 所 示 : 


public interface HandlerMethodArgumentResolver 1{ 


boolean supportsParameter (MethodParameter varl); 


Object resolveArgument (MethodParameter varl,ModelAndViewContainer var2, 
NativeWebRequest var3, WebDataBinderFactory var4) throws Exception; 
} 


HandlerMethodArgumentResolver 类 通过 supportsParameter 入 选 符合 条 件 的 resolver， 然 后 调 
用 resolver 的 resolveAreument 解析 前端 参数 。 Spring 提供 许多 


HandlerMethodArgumentResolver， 具 体 可 以 在 RequestMappingHandlerAdapter.afterPropertiesSet() 
方法 中 查看 。 


private List<HandlerMethodArgumentResolver> getDefaultArgumentResolvers() { 
List<HandlerMethodArgumentResolver> resolvers = new ArrayList<>(); 
// Annotation-based argument resolution 
resolvers.add (new RequestParamMethodArgumentResolver 
(getBeanFactory(), false)); 
resolvers.add (new RequestParamMapMethodArgumentResolver{()); 
resolvers.add (new PathVariableMethodArgumentResolver()); 


resolvers.add (new PathVariableMapMethodArgumentResolver ()); 
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} 


resolvers.add(new MatrixVariableMethodArgumentResolver ()); 

resolvers.add(new MatrixVariableMapMethodArgumentResolver ()); 

resolvers.add(new ServletModelAttributeMethodProcessor (false)); 

resolvers.add (new RequestResponseBodyMethodProcessor 
(getMessageConverters(), this.requestResponseBodyAdvice)); 

resolvers.add (new RequestPartMethodArgumentResolver 
(getMessageConverters(), this.requestResponseBodyAdvice)); 

resolvers.add (new RequestHeaderMethodArgumentResolver 
(getBeanFactory ())); 

resolvers.add (new RequestHeaderMapMethodArgumentResolver ()); 

resolvers.add (new ServletCookieValueMethodArgumentResolver 
(getBeanFactory ())); 

resolvers.add (new ExpressionValueMethodArgumentResolver 
(getBeanFactory())); 

resolvers.add(new SessionAttributeMethodArgumentResolver()); 

resolvers .add (new RequestAttributeMethodArgumentResolver()); 


// Type-based argument resolution 

resolvers.add(new ServletRequestMethodArgumentResolver ()); 
resolvers.add(new ServletResponseMethodArgumentResolver ()); 
resolvers.add (new HttpEntityMethodProcessor 
(getMessageConverters(), this.requestResponseBodyAdvice)); 
resolvers.add(new RedirectAttributesMethodArgumentResolver ()); 
resolvers.add(new ModelMethodProcessor ()); 

resolvers.add (new MapMethodProcessor()); 

resolvers.add (new ErrorsMethodArgumentResolver ()); 
resolvers.add(new SessionSstatusMethodArgumentResolver ());， 


resolvers.add(new UriComponentsBuilderMethodArgumentResolver ()); 


// Custom arguments 

if (getCustomArgumentResolvers() != null) { 
resolvers.addAll (getCustomArgumentResolvers ());，; 

} 


Gatech= all 

resolvers.add (new RequestParamMethodArgumentResolver 
(getBeanFactory(), true)); 

resolvers.add (new ServletModelAttributeMethodProcessor (true)); 


return resolvers; 


从 上 述 代 码 可 知 ， 除 了 Spring 提供 的 RequestParamMethodArgumentResolver 、 


Lo 
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PathVariable MethodArgumentResolver、SessionAttributeMethodArgumentResolver 等 默认 resolver 
之 外 ， 还 可 以 自 定义 resolver， 通 过 注解 来 指定 处 理 的 参数 类 型 ， 然后 通过 
getCustomArgumentResolvers 方法 会 注册 到 revolver 列表 。 下 面 以 
RequestParamMethodArgumentResolver 为 例 做 简单 的 分 析 ， 具 体 类 继承 关系 如 图 10-6 所 示 。 


| 
I HandlerMethodArgumentResolver | 


Pi 2 en 


E 2 AbstractNamedValueMethodArgumentResolver I UriComponentsContributor | 


ES 3 RegquestParamMethodArgumentResolver ， 


图 10-6 ”ServletInvocableHandlerMethod 类 继承 关系 


RequestParamMethodArgumentResolver 父 类 是 AbstractNamedValueMethodArgumentResolver， 
其 中 最 核心 的 方法 是 resolveArgument: 


public final Object resolveArgument (MethodParameter parameter, 
ModelAndViewContainer mavContainer, NativeWebRequest webRequest, 
WebDataBinderFactory binderFactory) throws Exception { 
AbstractNamedValueMethodArgumentResolver.NamedValuelinfo 
namedValueInfo = this.getNamedValuelnfo (parameter); 
MethodParameter nestedParameter = parameter.nestedIfOptional (); 
// 从 request 请 求 中 解析 参数 的 名 称 
Object resolvedName = this.resolveStringValue (namedValueIlInfo.name); 
if (resolvedName == null) { 
throw new IllegalArgumentException("Specified name must not 
resolve to null: [" + namedValueInfo.name + "]7")， 
} else { 
// 通 过 参数 名 称 获取 参数 值 
Object arg = this.resolveName (resolvedName.toString(), 


nestedParameter, webRequest); 


// 判 读 参数 值 是 否 为 空 
if (arg == null) { 
/ /判断 默认 值 是 否 为 空 
if (namedValueInfo.defaultValue != null) { 


// 如 果 设 置 默认 值 defaultvalue， 获 取 默 认 值 
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arg = this.resolveStringValue (namedValueInfo.defaultValue); 
// 判 断 是 否 是 必 填 选项 
} else if (namedValueInfo.required && !nestedqPararmeter .isOpPtional()){ 
// 如 果 是 必 填 选项 ， 调 用 handleMissingValue， 处 理 必 填 选项 前 端 无 传 值 情 况 
this.handleMissingValue (namedValueInfo.name, nestedParameter, 
webRequest); 


arg = this.handleNullValue (namedValueInfo.name, 
arg, nestedParameter.getNestedParameterType()); 
// 如 果 前 端 传 值 为 ”” 且 默认 值 不 为 空 
} else if ("".eduals (arg) && namedVvalueInfo.daefaulLtValue != null) 1{ 

arg = this.resolveStringValue (namedValueInfo.defaultValue); 
} 
if (binderFactory != null) { 

WebDataBinder binder = binderFactory.createBinder (webRequest, 


(Object)null, namedValueInfo.name); 
El 


// 重 点 : 真正 进行 类 型 转换 的 逻辑 
arg = binder.convertIifNecessary (arg, 


parameter.getParameterType(), parameter); 
} catch (ConversionNotSupportedException varll) { 
// 省 略 代 码 
} catch (TypeMismatchException varl2) { 


// 省 略 代码 


} 
this.handleResolvedValue (arg, namedValueInfo.name, parameter, 


mavContainer, webRequest); 
return arg> 


} 


由 上 述 代码 可 知 ，Spring MVC 框架 将 ServletRequest 对 象 及 处 理 方 法 的 参数 对 象 实例 传递 
给 DataBinder，DataBinder 会 调用 装配 在 Spring MVC 上 下 文 的 ConversionService 组 件 进 行 数据 
类 型 转换 、 数 据 格式 转换 工作 ， 并 将 ServletRequest 中 的 消息 填充 到 参数 对 象 中 。 然 后 再 调用 
Validator 组 件 对 绑 定 了 请 求 消息 数据 的 参数 对 象 进行 数据 合法 性 校 验 ， 并 最 终生 成 数据 绑 定 结 
果 BindingResult 对 象 。BindingResult 包含 已 完成 数据 绑 定 的 参数 对 象 ， 还 包含 相应 的 检验 错误 
对 象 。 
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10.3 ”视图 解析 器 


10.3.1 概述 


视图 解析 器 (ViewResolver) 是 Spring MVC 处 理 流程 中 的 最 后 一 个 环节 ，Spring MVC 流 
程 最 后 返回 给 用 户 的 视图 为 具体 的 View 对 象 ，View 对 象 包含 Model 对 象 ， 而 Model 对 象 存 放 
后 端 需要 反馈 给 前 端的 数据 。 视 图 解析 器 把 一 个 逻辑 上 的 视图 名 称 解析 为 一 个 有 具体 的 View 视 
图 对 象 ， 最 终 的 视图 可 以 是 JSP、Excel、JFreeChart 等 。 


10.3.2 ”视图 解析 流程 


SpringMVC 的 视图 解析 流程 为 : 


(1) SpringMVC 调用 目标 方法 ， 将 目标 方法 返回 的 String、View、ModelMap 或 
ModelAndView 都 转换 为 一 个 ModelAndView 对 象 。 

(2) 通过 视图 解析 器 ViewResolver 将 ModelAndView 对 象 中 的 View 对 象 进行 解析 ， 将 逻 
辑 视图 View 对 象 解析 为 一 个 物理 视图 View 对 象 。 

(3) 调用 物理 视图 View 对 象 的 render() 方 法 进行 视图 泻 染 ， 得 到 响应 结果 。 


10.3.3 ”常用 视图 解析 器 
Spring MVC 提供 很 多 视图 解析 器 类 ， 有 具体 如 图 10-7 所 示 。 


3 » ViewResolver 


不 Ns 
 » AbstractCachingViewResolver  » Ordered 
2 Er 
| ! | 
BS » UrlBasedViewResoiver S 。 ResourceBundleViewResolyer 3 >» XmlViewResolver 
| 「 ES a | 
3 » TiesViewResolver GroovyMarkupViewResolyer SS >» FreeMarkerViewResolver > nternalResourceViewResolver | 


图 10-7 ViewResolver 类 继承 关系 
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下 面 介 绍 一 些 常用 的 视图 解析 器 类 。 
1. ViewResolver 


ViewResolver 是 所 有 视图 解析 器 的 父 类 ， 具 体 源码 如 下 : 


public interface ViewResolver { 
@Nullable 
View resolveViewName (String viewName, Locale locale) throws Exception; 


} 


ViewResolver 的 主要 作用 是 把 一 个 逻辑 上 的 视图 名 称 解析 为 一 个 真正 的 视图 ， 然 后 通过 
View 对 象 进行 泻 染 。 
2. AbstractCachingViewResolver 


抽象 类 ， 这 种 视图 解析 器 会 把 解析 过 的 视图 保存 起 来 ， 然 后 在 每 次 解析 视图 时 先 从 缓存 里 
面 查 找 ， 如 果 找 到 了 对 应 的 视图 就 直接 返回 ， 如 果 没 有 找到 就 创建 一 个 新 的 视图 对 象 ， 然 后 把 
它 存放 到 用 于 缓存 的 Map 中 ， 接 着 再 把 新 建 的 视图 返回 。 使 用 这 种 视图 缓存 的 方式 可 以 把 解析 
视图 的 性 能 问题 降 到 最 低 。 


3. UrlBasedViewResolver 


该 类 继承 了 AbstractCachingViewResolver， 主 要 是 提供 一 种 拼接 URL 的 方式 来 解析 视图 ， 
它 可 以 让 我 们 通过 prefix 属性 指定 的 前 级 ， 通 过 suffix 属性 指定 后 级 ， 然 后 把 返回 的 逻辑 视图 名 
称 加 上 指定 的 前 级 和 后 级 就 是 指定 的 视图 URL 了 。 如 prefix=/WEB-INF/jsps/，suffix=.jsp， 返 回 
的 视图 名 称 viewName=test/indx ， 则 UrlBasedViewResolver 解析 出 来 的 视图 URL 就 是 
/WEB-INF/jsps/test/ index.jsp， 默 认 的 prefix 和 suffix 都 是 空 串 。 

URLBasedViewResolver 支持 返回 的 视图 名 称 中 包含 redirect: 前 级 ， 这 样 就 可 以 支持 URL 在 
客户 端的 跳 转 ， 如 当 返 回 的 视图 名 称 是 “redirect:test.do” 的 时 候 ，URLBasedViewResolver 发 现 
返回 的 视图 名 称 包 含 “redirect:” 前 级 ， 于 是 把 返回 的 视图 名 称 前 级 “redirect:” 去 掉 ， 取 后 面 的 
test.do 组 成 一 个 RedirectView，RedirectView 中 将 把 请 求 返回 的 模型 属性 组 合成 查询 参数 的 形式 
组 合 到 redirect 的 URL 后 面 ， 然 后 调用 HttpServletResponse 对 象 的 sendRedirect 方法 进行 重 定 
向 。 同 样 URLBasedViewResolver 还 支持 forword: 前 级， 对 于 视图 名 称 中 包含 forword: 前 级 的 视 
图 名 称 将 会 被 封装 成 一 个 InternalResourceView 对 象 ， 然 后 在 服务 器 端 利用 RequestDispatcher 的 
forword 方 式 跳 转 到 指定 的 地 址 。 使 用 UrlBasedViewResolver 的 时 候 必须 指定 属性 viewClass， 表 
示 解 析 成 哪 种 视图 ， 一 般 使 用 较 多 的 就 是 InternalResourceView， 利 用 它 来 展现 JSP， 但 是 当 使 
用 JSTL 的 时 候 必须 使 用 JstlView。 具 体 实例 如 下 所 示 : 


<bean 


class="org.springframework.web.servilet.view.UrlBasedViewResolver"> 
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<property name="prefix" value="/WEB-INF/" /> 

<property name="suffix" value=".jsp" /> 

<property name="viewClass" 
value="org.springframework.web.servlet.view.InternalResourceView"/> 


</bean> 


上 述 代 码 中 ， 当 返回 的 逻辑 视图 名 称 为 test 时 ，UrlBasedViewResolver 将 逻辑 视图 名 称 加 上 
定义 好 的 前 级 和 后 级 ， 即 “/WEB-INF/test.jsp”， 然 后 新 建 一 个 viewClass 属性 指定 的 视图 类 型 
予以 返回 ， 即 返回 一 个 URL 为 “/WEB-INF/test.jsp” 的 InternalResourceView 对 象 。 


4. InternalResourceViewResolver 


该 类 是 URLBasedViewResolver 的 子 类 ， 所 以 URLBasedViewResolver 支持 的 特性 它 都 支持 。 
InternalResourceViewResolver 是 使 用 最 广泛 的 一 个 视图 解析 器 。 可 以 把 
InternalResourceViewResolver 解释 为 内 部 资源 视图 解析 器 ，InternalResourceViewResolver 会 把 返 
的 视图 名 称 都 解析 为 InternalResourceView 对 象 ，InternalResourceView 会 把 Controller 处 理 器 
方法 返回 的 模型 属性 都 存放 到 对 应 的 request 属性 中 ， 然 后 通过 RequestDispatcher 在 服务 器 端 把 
请 求 forword 重 定向 到 目标 URL 。 比 如 在 InternalResourceViewResolver 中 定义 了 
prefix=/WEB-INF/，suffix=.jsp， 然 后 请 求 的 Controller 处 理 器 方法 返回 的 视图 名 称 为 test， 那 么 
这 个 时 候 InternalResourceViewResolver 就 会 把 test 解析 为 一 个 InternalResourceView 对 象 ， 先 把 
返回 的 模型 属性 都 存放 到 对 应 的 HttpServletRequest 属性 中 ， 然 后 利用 RequestDispatcher 在 服务 
器 端 把 请 求 forword 到 /WEB-INF/test.jsp。 这 就 是 InternalResourceViewResolver 一 个 非常 重要 的 
特性 。 

我 们 知道 ， 存 放 在 /WEB-INF/ 下 面 的 内 容 是 不 能 直接 通过 request 请 求 的 方式 请 求 到 的 ， 为 
了 安全 性 考虑 ， 通 常会 把 JSP 文件 放 在 WEB-INF 目录 下 ， 而 InternalResourceView 在 服务 器 端 
跳 转 的 方式 可 以 很 好 地 解决 这 个 问题 。 

<bean class="org.springframework.web.serolet.view. 

InternalResourceViewResolver"> 
<property name="prefix" value="/WEB-INF/"/> 
<property name="suffix" value=".jsp"></property> 
</bean> 


上 述 代 码 是 一 个 InternalResourceViewResolver 的 定义 ， 根 据 该 定义 当 返 回 的 逻辑 视图 名 称 

是 test 的 时 候 ，InternalResourceViewResolver 会 给 它 加 上 定义 好 的 前 级 和 后 级 ， 组 成 

“/WEB-INF/test.jsp ”的 形式 ， 然 后 把 它 当 做 一 个 InternalResourceView 的 URL 新 建 一 个 
InternalResourceView 对 象 返回 。 


仅 供 非 商业 用 途 或 交流 学 习 使 


非 卖 品 ， 仅 供 非 商业 用 途 或 交流 学 习 使 用 


198 | Spring MVC + MyBatis 快速 开发 与 项 目 实战 


5. XmlViewResolver 


它 继承 自 AbstractCachingViewResolver 抽象 类 ， 所 以 它 也 是 支持 视图 缓存 的 。 
XmlViewResolver 需要 给 定 一 个 XML 配置 文件 ， 该 文件 将 使 用 和 Spring 的 bean 工厂 配置 文件 
一 样 的 DTD 定义 ， 所 以 其 实 该 文件 就 是 用 来 定义 视图 的 bean 对 象 的 。 在 该 文件 中 定义 的 每 一 
个 视图 的 bean 对 象 都 给 定 一 个 名 字 ， 然 后 XmlViewResolver 将 根据 Controller 处 理 器 方法 返回 
的 逻辑 视图 名 称 到 XmlViewResolver 指定 的 配置 文件 中 寻找 对 应 名 称 的 视图 bean 用 于 处 理 视 
图 。 该 配置 文件 默认 是 /WEB-INF/views.xml 文件 ， 如 果 不 使 用 默认 值 的 时 候 可 以 在 
XmlViewResolver 的 location 属性 中 指定 它 的 位 置 。XmlViewResolver 还 实现 了 Ordered 接口 
因此 可 以 通过 其 order 属性 来 指定 在 ViewResolver 链 中 它 所 处 的 位 置 ，order 的 值 越 小 优先 级 越 
高 。 以 下 是 使 用 XmlViewResolver 的 一 个 示例 : 


<bean class="org.springframework.web.servlet.view.XmlViewResolver"> 
<property name="]ocation" value="/WEB-INF/views.xml"/> 
<property name="order" value="1"/> 

</bean> 


在 Spring MVC 的 配置 文件 中 加 入 XmlViewResolver 的 bean 定义 。 使 用 location 属性 指定 
其 配置 文件 所 在 的 位 置 ，order 属性 指定 当 有 多 个 ViewResolver 的 时 候 其 处 理 视图 的 优先 级 。 

在 XmlViewResolver 对 应 的 配置 文件 中 配置 好 所 需要 的 视图 定义 ， 视 图 配置 文件 views.xml 
具体 的 配置 如 下 所 示 : 


<?xml] version="1.0" encoding="UTF-8"?> 
<beans xmlns="http://www.springframework.org/schema/beans" 
xmlns:xsi="http://www.w3.o0rg/2001/XMLSchema-instance" 
xsi:schemaLocation="http://www.springframework.org/schema/beans 
http://www.springframework.org/schema/beans/spring-beans-3.0.xsd"> 
<bean id="index" 
class="org.springframework.web.servlet.view.InternalResourceView"> 
<property name="url" value="/index.jsp"/> 
</bean> 
</beans> 


最 后 ， 定 义 一 个 返回 的 逻辑 视图 名 称 为 在 XmlViewResolver 配置 文件 中 定义 的 视图 名 称 


index: 


@RequestMapping ("/index") 
PUbLLe SCreumo nd (yl 
return "index"; 
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当 访 问 上 面 定义 好 的 index 方法 的 时 候 返 回 的 逻辑 视图 名 称 为 “index”， 这 时 候 Spring 
MVC 会 从 views.xml 配 置 文件 中 寻找 id 或 者 name 为 “index” 的 bean 对 象 予以 返回 ， 这 里 Spring 
找到 的 是 一 个 URL 为 “/index.jsp” 的 InternalResourceView 对 象 ， 然 后 进行 视图 解析 ， 将 最 终 
的 视图 页 面 显示 给 用 户 。 


6. BeanNameViewResolver 


这 个 视图 解析 器 跟 XmlViewResolver 有 点 类 似 ， 也 是 通过 把 返回 的 逻辑 视图 名 称 匹配 定义 
好 的 视图 bean 对 象 。 主 要 的 区 别 有 两 点 : 


(1) BeanNameViewResolver 要 求 视 图 bean 对 象 都 定义 在 Spring 的 application context 中 ， 
而 XmlViewResolver 是 在 指定 的 配置 文件 中 寻找 视图 bean 对 象 。 
(2) BeanNameViewResolver 不 会 进行 视图 缓存 。 


下 面 来 看 一 个 具体 的 实例 : 


<bean class="org.springframework.web.servlet.view.BeanNameViewResolver"> 
<property name="order" value="1"/> 
</bean> 
<bean id="test" class="org.springframework.web.serviet.view. 
InternalResourceView"> 
<property name="url" value="/index.jsp"/> 
</bean> 


上 述 代码 中 ， 在 Spring MVC 的 配置 文件 中 定义 了 一 个 BeanNameViewResolver 视图 解析 器 
和 一 个 id 为 test 的 InternalResourceview bean 对 象 。 这 样 当 返回 的 逻辑 视图 名 称 为 test 时 ， 就 会 
解析 为 上 面 定 义 好 的 id 为 test 的 InternalResourceView 对 象 ， 然 后 跳 转 到 index.jsp 页 面 。 


7. ResourceBundleViewResolver 


该 类 也 是 继承 自 AbstractCachingViewResolver 类 ， 但 是 它 缓存 的 不 是 视图 。 和 
XmlViewResolver 一 样 ， 它 也 需要 有 一 个 配置 文件 来 定义 逻辑 视图 名 称 和 真正 的 View 对 象 的 对 
应 关系 ， 不 同 的 是 ResourceBundleViewResolver 的 配置 文件 是 一 个 属性 文件 ， 而 且 必须 是 放 在 
classpath 路 径 下 面 的 ， 默 认 情况 下 这 个 配置 文件 是 在 classpath 根 目录 下 的 views.properties 文 
件 ， 如 果 不 使 用 默认 值 ， 则 可 以 通过 属性 baseName 或 baseNames 来 指定 。baseName 只 是 指定 
一 个 基 名 称 ，Spring 会 在 指定 的 classpath 根 目 录 下 寻找 已 指定 的 baseName 开始 的 属性 文件 进行 
View 解析 ， 如 指定 的 baseName 是 base， 那 么 base.properties、baseabc.properties 等 以 base 开始 
的 属性 文件 都 会 被 Spring 当做 ResourceBundleViewResolver 解析 视图 的 资源 文件 。 
ResourceBundleViewResolver 使 用 的 属性 配置 文件 的 内 容 类 似 于 这 样 : 
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resourceBundle. (class)=org.springframework.web.servlet.view.I1nternalReso 
urceView 

resourceBundle.url=/index.jsp 

test. (class)=org.springframework.web.servilet.view.InternalResourceView 


test.url=/test.jsp 


在 这 个 配置 文件 中 定义 了 两 个 InternalResourceView 对 象 ， 一 个 名 称 是 resourceBundle， 对 
应 的 URL 是 /index.jsp， 男 一 个 名 称 是 test， 对 应 的 URL 是 /testjsp。 从 这 个 定义 可 以 知道 ， 
resourceBundle 是 对 应 的 视图 名 称 ， 使 用 resourceBundle.(class) 来 指定 它 对 应 的 视图 类 型 ， 
resourceBundle.url 指定 这 个 视图 的 URL 属性 。 

读者 可 以 看 到 ，resourceBundle 的 class 属性 要 用 小 括号 包 起 来 ， 而 它 的 URL 属性 为 什么 不 
需要 呢 ? 这 就 需要 从 ResourceBundleViewResolver 进行 视图 解析 的 方法 来 说 明 。 
ResourceBundleViewResolver 还 是 通过 bean 工厂 来 获得 对 应 视图 名 称 的 视图 bean 对 象 来 解析 视 
图 的 ， 那 么 这 些 bean 从 哪里 来 呢 ? 就 是 从 我 们 定义 的 properties 属性 文件 中 来 。 在 
ResourceBundleViewResolver 第 一 次 进行 视图 解析 的 时 候 会 先 new 一 个 BeanFactory 对 象 ， 然 后 
把 properties 文件 中 定义 好 的 属性 按照 它 自身 的 规则 生成 一 个 个 的 bean 对 象 注册 到 该 
BeanFactory 中 ， 之 后 会 把 该 BeanFactory 对 象 保存 起 来 ， 所 以 ResourceBundleViewResolver 缓存 
的 是 BeanFactory， 而 不 是 直接 缓存 从 BeanFactory 中 取出 的 视图 bean。 然 后 会 从 bean 工厂 中 取 
出 名 称 为 逻辑 视图 名 称 的 视图 bean 进行 返回 。 

接 下 来 介绍 Spring 通过 properties 文件 生成 bean 的 规则 。 它 会 把 properties 文件 中 定义 的 属 
性 名 称 按 最 后 一 个 点 “.” 进 行 分 制 ， 把 点 前 面 的 内 容 当 做 是 bean 名 称 ， 点 后 面 的 内 容 当 做 是 
bean 的 属性 。 这 其 中 有 几 个 特别 的 属性 ，Spring 把 它们 用 小 括号 包 起 来 了 ， 这 些 特殊 的 属性 一 
般 是 对 应 的 attribute， 但 不 是 bean 对 象 所 有 的 attribute 都 可 以 这 样 用 。 其 中 (class) 是 一 个 ， 除 
了 (class) 之 外 ， 还 有 (scope) 、 (parent) 、 (abstract) 、 (lazy-init) 。 而 除了 这 些 特殊 的 
属性 之 外 的 其 他 属性 ，Spring 会 把 它们 当做 bean 对 象 的 一 般 属性 进行 处 理 ， 就 是 bean 对 象 对 应 
的 property。 所 以 根据 上 面 的 属性 配置 文件 将 生成 如 下 两 个 bean 对 象 : 


<bean id="resourceBundle" 

class="org.springframework.web.servlet.view.InternalResourceView"> 
<property name="url" value="/index.jsp"/> 

</bean> 

<bean id="test" 

class="org.springframework.web.servlet.view.InternalResourceView"> 
<property name="url" value="/test.jsp"/> 

</bean> 
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8. FreeMarkerViewResolver 


FreeMarkerViewResolver 是 UrlBasedViewResolver 的 一 个 子 类 ， 它 会 把 Controller 处 理 方法 
返回 的 逻辑 视图 解析 为 FreeMarkerView。FreeMarkerViewResolver 会 按照 UrlBasedViewResolver 
拼接 URL 的 方式 进行 视图 路 径 的 解析 ， 但 是 使 用 FreeMarkerViewResolver 的 时 候 不 需要 指定 其 
viewClass， 因 为 FreeMarkerViewResolver 中 已 经 把 viewClass 定 死 为 FreeMarkerView 了 。 我 们 
先 在 Spring MVC 的 配置 文件 里 面 定义 一 个 FreeMarkerViewResolver 视图 解析 器 ， 并 定义 其 解析 
视图 的 order 顺序 为 1， 代码 示例 如 下 : 


<bean 


class="org.springframework.web.servilet.view.freemarker.FreeMarkerViewRes 
olver"> 
<property name="prefix'" value="fm "/> 
<property name="suffix" value=".ft1"/> 
<property name="order" Value="1"/> 
</bean> 


当 请 求 的 处 理 器 方法 返回 一 个 逻辑 视图 名 称 viewName 的 时 候 ， 就 会 被 该 视图 处 理 器 加 上 
前 后 级 解析 为 一 个 URL 为 “fm viewName.ftl” 的 FreeMarkerView 对 象 。 对 于 FreeMarkerView 
需要 给 定 一 个 FreeMarkerConfig 的 bean 对 象 来 定义 FreeMarker 的 配置 信息 。FreeMarkerConfig 
是 一 个 接口 ，Spring 已 经 为 我 们 提供 了 一 个 实现 ， 它 就 是 FreeMarkerConfigurer。 可 以 通过 在 
Spring MVC 的 配置 文件 里 定义 该 bean 对 象 来 定义 FreeMarker 的 配置 信息 ， 该 配置 信息 将 会 在 
FreeMarkerView 进行 泻 染 的 时 候 使 用 到 。 对 于 FreeMarkerConfigurer 而 言 ， 最 简单 的 就 是 配置 一 
个 templateLoaderPath ， 告 诉 Spring 应 该 到 哪里 寻找 FreeMarker 的 模板 文件 。 这 个 
templateLoaderPath 也 支持 使 用 “classpath:” 和 “file:” 前 缀 。 当 FreeMarker 的 模板 文件 放 在 多 
个 不 同 的 路 径 下 面 的 时 候 ， 可 以 使 用 templateLoaderPaths 属性 来 指定 多 个 路 径 。 在 这 里 指定 模 
板 文件 放 在 “/WEB-INF/freemarker/template” 下 面 ， 示 例 代码 如 下 : 


<bean 
class="org.springframework.web.servlet.view.freemarker. 
FreeMarkerConfigurer"> 
<property name="templateLoaderPath" value="/WEB-INF/freemarker/ 
template"/> 


</bean> 


10.3.4 ”ViewResolver 链 


在 Spring MVC 中 可 以 同时 定义 多 个 ViewResolver 视图 解析 器 ， 然 后 它们 会 组 成 一 个 
ViewResolver 链 。 当 Controller 处 理 器 方法 返回 一 个 逻辑 视图 名 称 后 ，ViewResolver 链 将 根据 其 
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中 ViewResolver 的 优先 级 来 进行 处 理 。 所 有 的 ViewResolver 都 实现 了 Ordered 接口 ， 在 Spring 
中 实现 了 这 个 接口 的 类 都 是 可 以 排序 的 。ViewResolver 是 通过 order 属性 来 指定 顺序 的 ， 默 认 都 
是 最 大 值 。 所 以 可 以 通过 指定 ViewResolver 的 order 属性 来 实现 ViewResolver 的 优先 级 ，order 
属性 是 Integer 类 型 ，order 越 小 优先 级 越 高 ， 所 以 第 一 个 进行 解析 的 将 是 ViewResolver 链 中 
order 值 最 小 的 那个 。 

如 果 ViewResolver 进行 视图 解析 后 返回 的 View 对 象 为 null， 则 表示 ViewResolver 不 能 
析 该 视图 ， 这 个 时 候 如 果 还 存在 其 他 order 值 比 它 大 的 ViewResolver， 就 会 调用 剩余 的 
ViewResolver 中 order 值 最 小 的 那个 来 解析 该 视图 ， 依 此 类 推 。 当 ViewResolver 在 进行 视图 解析 
后 返回 的 是 一 个 非 空 的 View 对 象 的 时 候 ， 则 表示 该 ViewResolver 能 够 解析 该 视图 ， 那 么 视图 解 
析 就 完成 了 ， 后 续 的 ViewResolver 将 不 会 再 用 来 解析 该 视图 。 当 定义 的 所 有 ViewResolver 都 不 
能 解析 该 视图 的 时 候 ，Spring 就 会 抛 出 一 个 异常 。 

基于 Spring 支持 的 这 种 ViewResolver 链 模 式 ， 就 可 以 在 Spring MVC 应 用 中 同时 定义 多 个 
ViewResolver， 给 定 不 同 的 order 值 ， 这 样 就 可 以 对 特定 的 视图 进行 处 理 ， 以 此 来 支持 同一 应 用 
中 有 风 种 视 图 类 型 。 


【! | 像 PnternalResourceViewResolver 这 种 能 解析 所 有 的 视图 , 即 永远 能 返回 一 个 非 空 View 
六 虽 Wg§ 对 象 的 ViewResolver， 一 定 要 把 它 放 在 ViewResolver 链 的 最 后 面 。 
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11.1 MyBatis 整体 框架 


MyBatis 原理 剖析 


本 章 主要 介绍 MyBatis 的 整体 框架 、MyBatis 的 初始 化 流程 和 原理 以 及 MyBatis 的 执行 流程 
和 原理 等 。 


11.1.1 概述 
Mybatis 整体 架构 分 为 三 层 ， 分 别 是 基础 支持 层 、 核 心 处 理 层 和 接口 屋 ， 有 具体 如 图 11-1 所 示 。 


11.1.2 ”接口 层 


接口 层 是 上 层 运用 与 MyBatis 交互 的 桥梁 ， 其 核心 是 SqlSession 接口 。SqlSession 接口 暴露 
了 一 系列 的 增删 改 查 等 API 给 应 用 程序 。 接 口 层 在 接收 到 调用 请 求 时 ， 会 调用 核心 处 理 层 的 相 
应 模块 完成 具体 的 数据 库 操作 。MySQL 提供 了 两 个 SqlSession 接口 的 实现 ， 有 具体 如 图 11-2 
所 示 。 
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图 11-2 ”SqlSession 接口 实现 


由 图 11-2 可 知 ，SqlSession 接口 实现 使 用 了 工厂 方法 模式 ，SqlSessionFactory 负责 创建 
SqlSession 对 象 ， 其 包含 多 个 openSession() 方 法 的 重 载 ， 可 以 通过 参数 指定 事务 的 隔离 级 别 
TransactionIsolationLevel、 底 层 使 用 Excutor 的 类 型 以 及 是 否 自动 提交 事务 等 方面 的 配置 。 
SqlSessionFactory 具体 源码 如 下 : 


public interface SqlSessionFactory { 
SqlSession openSession(); 


SqlSession openSession (boolean autoCommit); 


SgqlSession openSession (Connection connection); 
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SqlSession openSession(TransactionIsolationLevel level); 


SqlSession openSession (ExecutorType execType); 

SqlSession openSession (ExecutorType execType, boolean autoCommit); 

SqlSession openSession (ExecutorType execType, 
TransactionIsolationLevel level); 


SgqlSession openSession (ExecutorType execType, Connection connection); 
Configuration getConfiguration(); 


} 


SqlSession 接口 提供 了 常用 的 增删 改 查 的 数据 库 操 作 以 及 事务 的 相关 操作 。 同 时 ， 每 种 类 
型 的 操作 都 提供 了 多 种 重 载 。SqlSessionFactory 具体 源码 如 下 : 


public interface SqlSession extends Closeable { 
// 查 询 方法 : 使 用 SQL 语句 查询 ， 返 回 值 为 查询 的 结果 对 象 
<T> T selectOne (String statement); 
// 查 询 方 法 : 使 用 SQL 语句 查询 ， 第 二 个 参数 表示 用 户 传 入 的 参数 ， 也 就 是 SQL 语句 绑 定 的 实 参 
<T> T selectOne (String statement, Object parameter); 
// 查 询 方法 : 用 来 查询 多 条 记录 ， 查 询 结 果 封装 成 结果 对 象 列表 返回 
<E> List<E> selectList (String statement); 
<E> List<E> selectList (String statement, Object parameter); 
// 带 分 页 的 查询 方法 : 第 三 个 参数 用 来 限制 解析 结果 集 的 范围 
<E> List<E> selectList(String statement, Object parameter, 
RowBounds rowBounds); 
// 查 询 方法 .查询 结果 会 被 映射 成 Map 对 象 返回 。 其 中 ， 第 二 个 参数 指定 了 结果 集 哪 一 列 作 为 
Map 的 key 
<K, V> Map<K, V> selectMap (String statement, String mapKey); 
<K, V> Map<K, V> selectMap (String statement, Object parameter, 
String mapKey); 
// 返 回 值 为 游标 对 象 ， 参 数 含义 与 selectList () 方 法 相同 
<T> Cursor<T> selectCursor (String statement) 
<T> Cursor<T> selectCursor (String statement, Object parameter); 
<T> Cursor<T> selectCursor (String statement, Object parameter, 
RowBounds rowBounds); 
// 查 询 的 结果 对 象 将 由 ResultHandler 对 象 处 理 ， 其 余 参数 与 selectList () 方 法 相同 
void select (String statement, Object parameter, ResultHandler handler); 
void select (String statement, ResultHandler handler); 
void select (String statement, Object parameter, RowBounds rowBounds, 
ResultHandler handler); 


// 执 行 插入 语句 
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int insert(String statement); 

int insert (String statement, Object parameter); 
/ /执行 更 新 语句 

int update (String statement); 

int update(String statement, Object parameter); 
// 执 行 删除 语句 

int delete(String statement) ， 

int aelete (String statement, Object parameter); 
// 提 交 事 务 

void commit () ， 

void commit (boolean force) 

// 回 滚 事务 

void rollback(); 

void rollback (boolean force); 

// 将 请 求 刷新 到 缓存 

List<BatchResult> flushStatements (); 

// 关 闭 session 

void close(); 

// 清 空 缓 存 

void clearCache () : 

// 获 取 Configuration 对 象 

Configuration getConfiguration(); 

// 获 取 type 对 应 的 Mapper 对 象 

<T> T getMapper (Class<T> type); 

// 获 取 Sqlsession 对 应 的 数据 库 连 接 


Connection getConnection(); 


11.1.3 ”核心 处 理 层 


MyBatis 核心 处 理 层 完成 MyBatis 核心 处 理 流程 ， 包 括 MyBatis 的 初始 化 及 完成 一 次 数据 库 
操作 所 涉及 的 全 部 流程 。 具 体 说 明 如 下 。 


1 


. 参数 映射 


MyBatis 在 初始 化 过 程 中 ， 会 加 载 配置 文件 mybatis-config.xml、 映 射 配置 文件 以 及 Mapper 
接口 中 的 注解 信息 ， 解 析 配 置 文件 后 会 生成 相关 的 对 象 保存 到 Configuration 对 象 中 。 例 如 以 下 
代码 中 的 <resultMap> 节 点 会 被 解析 成 ResultMap 对 象 ，<result> 节 点 会 被 解析 成 ResultMapping 
对 象 。 利 用 Configuration 对 象 可 以 创建 SqlSessionFactory 对 象 ， 并 通过 SqlSessionFactory 工程 
对 象 创建 SqlSession 对 象 完 成 数据 库 操 作 。 


Lm 
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<resultMap id="userMap" type="com.ay.model .AyUser"> 
<id property="id" column="id"/> 
<result property="name" column="name"/> 
</resultMap> 


2. SQL 解析 

MyBatis 实现 动态 SQL 语句 的 功能 ， 提 供 了 多 种 动态 SQL 语句 对 应 的 节点 ， 比 如 <where> 
节点 、<i 他 节点 、<foreach> 节 点 等 。 通 过 这 些 节点 的 组 合 使 用 ， 开 发 人 员 可 以 写 出 满足 所 有 需 
求 的 动态 SQL 语句 。MyBatis 会 根据 用 户 传 入 的 实 参 ， 解 析 映 射 文件 中 定义 的 动态 SQL 节点 ， 
生成 可 执行 的 SQL 语句 。 之 后 会 处 理 SQL 语句 中 的 占 位 符 ， 绑 定 用 户 传 入 的 实 参 。 

3. SQL 执行 与 结果 处 理 和 映射 


SQL 语句 执行 涉及 Executor、StatementHandler、PreparedHandler 和 ResultSetHandler。 其 中 
Executor 主要 负责 维护 一 级 缓存 和 二 级 缓存 ， 并 提供 事务 管理 的 相关 操作 ， 它 会 将 数据 库 相 关 
操作 委托 给 StatementHandler 完成 。StatementHandler 首先 通过 PreparedHandler 完成 SQL 语句 的 
实 参 绑 定 ， 然 后 通过 Statement 对 象 执 行 SQL 语句 并 得 到 结果 集 ， 最 后 通过 ResultSetHandler 完 
成 结果 集 的 映射 ， 得 到 结果 对 象 并 返回 。 


11.1.4 ”基础 支撑 层 


包括 以 下 几 方 面 的 任务 : 

1. 事务 管理 

项 目 开发 过 程 中 ， 一 般 很 少 直接 使 用 MyBatis 事务 管理 ， 而 是 MyBatis 和 Spring 框架 集成 
时 ， 使 用 Spring 框架 管理 事务 。MyBatis 框架 又 对 数据 库 中 的 事务 进行 了 抽象 ， 其 自身 提供 了 
相应 的 事务 接口 和 简单 实现 。 

2. 数据 源 


顾名思义 ， 数 据 的 来 源 ， 是 提供 某 种 所 需要 数据 的 器 件 或 原始 媒体 。 在 数据 源 中 存储 了 所 
有 建立 数据 库 连 接 的 信息 。 就 像 通过 指定 文件 名 称 可 以 在 文件 系统 中 找到 文件 一 样 ， 通 过 提供 
正确 的 数据 源 名 称 ， 你 可 以 找到 相应 的 数据 库 连 接 。MyBatis 提供 了 相应 的 数据 源 实现 ， 当 然 
MyBatis 也 提供 了 与 第 三 方 数据 源 集成 的 接口 ， 这 些 功 能 都 位 于 数据 源 模块 中 。 

3. 缓存 管理 

MyBatis 中 提供 了 一 级 缓存 和 二 级 缓存 。 需 要 注意 的 是 ，MyBatis 中 自 带 的 这 两 级 缓存 与 
MyBatis 以 及 整个 应 用 是 运行 在 同一 个 JVM 中 的 ， 共 享 同 一 块 堆 内 存 。 如 果 这 两 级 缓存 中 的 数 
据 量 较 大 ， 则 可 能 影响 系统 中 其 他 功能 的 运行 ， 所 以 当 需 要 缓存 大 量 数据 时 ， 建 议 优先 考虑 使 
用 Redis、Memcache 等 缓存 产品 。 


< 
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4. 反射 模块 

MyBatis 提供 反射 模块 对 Java 原生 的 反射 进行 良好 的 封装 ， 其 提供 了 简洁 的 API， 方 便 上 
层 使 用 ， 并 且 对 反射 操作 进行 一 系列 优化 ， 例 如 缓存 了 类 的 元 数据 ， 提 高 了 反射 操作 的 性 能 。 

5. 系统 日 志 

MyBatis 日 志 模 块 的 主要 功能 是 集成 第 三 方 日 志 框 架 ， 例 如 Log4j、Log4j2、slf4j 等 。 除 此 
之 外 ，MyBatis 还 提供 了 详细 的 日 志 输 出 信息 。 

6. Binding 模 块 

MyBatis 通过 Binging 模块 将 用 户 自 定义 的 Mapper 接口 与 映射 配置 文件 关联 起 来 ， 系 统 可 以 
通过 自 定义 Mapper 接口 中 的 方法 执行 相应 的 SQL 语句 完成 数据 库 操作 。 

7. 类 型 转换 

MyBatis 为 简化 配置 文件 提供 了 别名 机 制 ， 该 机 制 是 类 型 转换 模块 的 主要 功能 之 一 。 类 型 
转换 模块 的 另 一 个 功能 是 实现 JDBC 类 型 与 Java 类 型 之 间 的 转换 ， 该 功能 在 为 SQL 语句 绑 定 实 
参 以 及 映射 查询 结果 集 时 都 会 涉及 。 在 为 SQL 语句 绑 定 实 参 时 ， 会 将 数据 由 Java 类 型 转换 为 
JDBC 类 型 ， 而 在 映射 结果 集 时 ， 会 将 数据 由 JDBC 类 型 转换 为 Java 类 型 。 


8. 解析 器 模块 
MyBatis 的 解析 器 模块 主要 提供 了 以 下 两 个 功能 : 


(1) 对 Xpath 进行 封装 ， 为 MyBatis 初始 化 时 解析 mybatis-config.xml 配置 文件 以 及 映射 配 
置 文件 提供 支持 。 
(2) 为 处 理 动态 SQL 语句 中 的 占 位 符 提供 支持 。 


9. 资源 加 载 


MyBatis 的 资源 加 载 模块 主要 是 对 类 加 载 器 进行 封装 ， 确 定 类 加 载 器 的 使 用 顺序 ， 并 提供 
加 载 类 文件 以 及 其 他 资源 文件 的 功能 。 


11.2 ”MyBatis 初始 化 流程 


任何 框架 的 启动 ， 无 非 是 加 载 自己 运行 时 所 需要 的 配置 信息 ，MyBatis 的 配置 信息 主要 在 
mybatis-config.xml 文件 里 配置 ， 具 体 代码 如 下 所 示 ; 


gc 


非 卖 品 ， 仅 供 非 商业 用 途 或 交流 学 习 使 


第 11 章 MyBatis 原理 剖析 | 209 


<?2xm] version="1.0" encoding="UTF-8" ?> 
<!IDOCTYPE configuration 
PUBLIC "-//mybatis.org//DTD Config 3.0//EN" 
"nttp://mybatis.org/dtd/mybatis-3-config.dtd"> 
<configuration> 
<!-- 设置 --> 
<settings></settings> 
< /i > 
<properties></properties> 
<!1-- 类 型 命名 --> 
<typeAliases></typeAliases> 
<!-- 类 型 处 理 器 -=-> 
<typeHandlers></typeHandlers> 


<!- 一 对 象 上 局 一 -> 
<objectFactory type="" ></objectFactory> 
Se 
<plugins> 

<plugin interceptor=""></plugin> 
</plugins> 
<!-- 环境 -=> 
<environments default=""> 

<!1-- 环境 变量 -=> 


<environment id=""> 
<!-- 事务 管理 器 --> 
<transactionManager type=""></transactionManager> 
<!-- 数据 源 --> 
<dataSource type=""></dataSource> 
</environment> 
</environments> 
<!-- 数据 库 厂商 标识 --> 
<databaseIdProvider type=""></databaseldProvider> 
<!-- 映射 占 --> 
<mappers></mappers> 
</configuration> 


上 述 的 XML 配置 信息 ，MyBatis 使 用 Configuration 对 象 作为 配置 信息 的 容器 ， 
Configuration 对 象 的 组 织 结构 和 XML 配置 文件 的 组 织 结构 几乎 完全 一 样 。MyBatis 完成 
Configuration 对 象 初始 化 之 后 ， 用 户 就 可 以 使 用 MyBatis 进行 数据 库 操作 了 。 换 言 之 ，MyBatis 
初始 化 的 过 程 ， 就 是 创建 Configuration 对 象 的 过 程 。 


非 卖 品 ， 仅 供 非 商业 用 途 或 交流 学 习 使 用 


210 | Spring MVC + MyBatis 快速 开发 与 项 目 实战 


首先 ， 来 看 下 面 的 一 个 简单 实例 : 


String resource = "mybatis-config.xml"; 

InputSstream inputStream = Resources.getResourceAsStream(resource); 

/ /初始 化 流程 主要 代码 

SqlSessionFactory sqlSessionFactory = new 
SqlSessionFactoryBuilder() .build(inputStream); 

SqlSession sqlSession = sqlSessionFactory.openSession(); 

List list = SqlSession.selectList("") ， 


上 述 代 码 执行 过 程 如 下 : 


(1) 将 配置 文件 mybatis-config.xml 加 载 成 InputStream 输入 流 。 

(2) 通过 SqlSessionFactoryBuilder 的 build() 方 法 创建 SqlSessionFactory 对 象 。 
(3) 通过 SqlSessionFactory 的 openSession() 方 法 创建 SqlSession 对 象 。 

(4) 执行 Mapper 文件 中 的 查询 语句 ， 获 取 查 询 结 果 。 


MyBatis 的 初始 化 流程 主要 发 生 在 步骤 (2) ，SqlSessionFactoryBuilder 根据 传 入 的 数据 流 
生成 Configuration 对 象 ， 然 后 根据 Configuration 对 象 创 建 默认 的 SqlSessionFactory 实例 。 初 始 
化 的 基本 过 程 如 图 11-3 所 示 。 


| sqlsessionractoryeuilder XMiConfigBuilder SqlSessionFactory 
人 jent 


4 : 


"1、build(inputStream : : 

2. new XMLConfigBuilder( : 

3 PAarse( : 

ri 4、return Con 有 Guration~ 一 一 一 一 一 : 
: 5 buidCconfgurntion 二 一 一 一 一 一 

: #0 0 8 tite teen po mre deo eos eo een 6 return Sqlsessionfactory Wateh ons rp mi mnieit nl mn nin ~ 


i "7. SqlSessionFactory ~ | 


图 11-3 MyBatis 初始 化 流程 
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由 图 11-3 可 知 ，Mybatis 初始 化 要 经 过 以 下 几 步 : 


(1) 客户 端 Client 调用 SqlSessionFactoryBuilder 对 象 的 build (inputStream) 方法 。 

(2) SqlSessionFactoryBuilder 会 根据 输入 流 inputStream 等 信息 创建 XMLConfigBuilder 
对 象 。 

(3) SqlSessionFactoryBuilder 调用 XMLConfigBuilder 对 象 的 parse() 方 法 。 

(4) XMLConfigBuilder 对 象 返 回 Configuration 对 象 。 

(5) SqlSessionFactoryBuilder 根据 Configuration 对 象 创 建 一 个 DefaultSessionFactory 对 象 。 

(6) SqlSessionFactoryBuilder 返回 DefaultSessionFactory 对 象 给 Client， 供 Client 使 用 。 


11.3 ”MyBatis 执行 流程 


首先 ， 我 们 再 来 看 之 前 这 个 简单 实例 : 


String resource = "mybatis-config.xml"; 
InputStream inputStream = Resources.getResourceAsStream(resource); 
// 初 始 化 流程 
SqlSessionFactory sqlSessionFactory = new 
SqlSessionFactoryBuilder() .build(inputSstream); 
// 执 行 流程 
SqlSession sqlSession = sqlSessionFactory.openSession(); 
// 执 行 流程 
List list= sqlSession.selectList("com.ay.dao.AyUserDao. findBylId", param); 
sqlSession.close(); 


SqlSessionFactory sqlSessionFactory = new SqlSessionFactoryBuilder().build(inputStream); 主 要 
涉及 MyBatis 的 初始 化 流程 ， 而 sqlSessionFactory.openSession()、sqlSession.selectList(") 和 和 
sqlSession.close() 涉 及 MyBatis 执行 流程 。MyBatis 执行 流程 具体 如 图 11-4 所 示 〈 参 考 网 络 
图 片 ) 。 


(1)SqlSessionFactory 调用 openSession() 方 法 获取 SqlSession 对 象 ，SqlSession 对 象 封装 了 
对 数据 库 的 CRUD 增 删改 查 ) 和 事务 控制 。 

(2) 为 SqlSession 传递 一 个 配置 SQL 语句 的 Statement Id 和 参数 ， 人 然后 返回 结果 。 具 体 代 
码 如 下 : 
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图 11-4 MyBatis 执行 流程 


// 执 行 流程 

List list= sqlSession.selectList("com.ay.dao.AyUserDao. findById", param); 

AyUserMapper .xml 部 分 代码 如 下 : 

<?2xml version="1.0" encoding="UTF-8" ?> 

<!IDOCTYPE mapper PUBLIC "-//mybatis.org//DTD Mapper 3.0//EN" 
"http://mybatis.org/dtd/mybatis-3-mapper.dtd"> 

<mapper namespace="com.ay.dao.AyUserDao"> 

<select id="findById" useCache="false" parameterType="String" 

resultMap="userMap"> 

SELECT * FROM ay user 
WHERE id = #{id} 
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</select> 
</mapper> 


对 应 的 Dao 部 分 代码 如 下 : 


QRepository 
public interface AyUserDao { 
AyUser findById (string id); 

} 

此 时 ，Statement Id = namespace + <select> 标 签 的 id 属性 ， 即 com.ay.dao.AyUserDao. 
findById，param 是 传递 的 查询 参数 。MyBatis 在 初始 化 的 时 候 ， 会 将 MyBatis 的 配置 信息 全 部 
加 载 到 内 存 中 ， 使 用 Configuration 实例 来 维护 。 可 以 使 用 sqlSession.getConfiguration() 方 法 来 获 
取 。AyUserMapper.xml 配置 文件 加 载 到 内 存 中 会 生成 一 个 对 应 的 MappedStatement 对 象 ， 然 后 
以 key=" com.ay.dao.AyUserDao. findById "，value 为 MappedStatement 对 象 的 形式 维护 到 
Configuration 的 一 个 Map 中 。 当 以 后 需要 使 用 的 时 候 ， 只 需要 通过 Id 值 获 取 即 可 。 综 上 所 述 ， 
SqlSession 的 职能 是 ， 根 据 Statement Id， 在 Mybatis 配置 对 象 Configuration 中 获取 到 对 应 的 
MappedStatement 对 象 ， 然 后 调用 Mybatis 执行 器 来 执行 具体 的 操作 。 

(3) MyBatis 执行 器 Executor 根据 SqlSession 传递 的 参数 执行 query(0) 方 法 ， 最 后 会 创建 一 
个 StatementHandler 对 象 ， 然 后 将 必要 的 参数 传递 给 StatementHandler， 使 用 StatementHandler 
来 完成 对 数据 库 的 查询 ， 最 终 返 回 List 结果 集 。 
Executor 的 功能 和 作用 是 : 


@ 根据 传递 的 参数 ， 完 成 SQL 语句 的 动态 解析 ， 生 成 BoundSql 对 象 ， 供 StatementHandler 
使 用 。 

@ 为 查询 创建 缓存 ， 以 提高 性 能 。 

@ 创建 JDBC 的 Statement 连 接 对 象 ， 传 递 给 StatementHandler 对 和 象 ， 返 回 List 查 询 结果 。 


(4) StatementHandler 对 象 负责 设置 Statement 对 象 中 的 查询 参数 、 处 理 JDBC 返回 的 
resultSet， 将 resultSet 加 工 为 List 集合 返回 。 
StatementHandler 对 象 主要 完成 以 下 两 个 工作 : 


e@ 对 于 JDBC 的 PreparedStatement 类 型 的 对 象 ， 在 创建 的 过 程 中 ， 使 用 的 是 SQL 语句 ， 字 
符 串 会 包含 若干 个 “?” 占 位 符 ， 其 后 再 对 占 位 符 进 行 设 值 ，StatementHandler 通 过 
parameterize(statement) 方 法 对 Statement 进 行 设 值 。 

e@ StatementHandler 通 过 List<E> query(Statement statement，ResultHandler resultHandler) 方 
法 来 完成 执行 Statement， 和 将 Statement 对 象 返 回 的 resultSet 封 装 成 List。 
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StatementHandler 的 ”parameterize(Statement) 方 法 调 用 了 ParameterHandler 的 
setParameters(statement) 方 法 ，ParameterHandler 的 setParameters(Statement) 方 法 负责 根据 输入 的 
参数 ， 对 statement 对 象 的 “? ” 占 位 符 处 进行 赋值 。 具 体 源码 如 下 : 


public class PreparedStatementHandler extends BaseStatementHandler { 
QOverride 
public void parameterize(Statement statement) throws SQLException { 
// 使 用 ParameterHandler 对 象 完成 对 Statement 的 设 值 
parameterHandler.setParameters( (PreparedStatement) statement) ， 


} 


QOverride 
public <E> List<E> query (Statement statement, ResultHandler resultHandler) 
throws SQLException f{ 

PreparedStatement ps = (PreparedStatement) statement; 

BS-execute 全 元 

return resultSetHandler.<E> handleResultSets (ps); 


} 


从 上 述 代 码 可 以 看 出 ，StatementHandler 的 List<E> query(Statement statement, ResultHandler 
resultHandler) 方 法 的 实现 ， 是 调用 了 ResultSetHandler 的 handleResultSets(Statement) 方 法 。 
ResultSetHandler 的 handleResultSets(Statement) 方法 会 将 Statement 语句 执行 后 生成 的 resultSet 
结果 集 转换 成 List<E> 结果 集 。 

上 述 步 又 即 MyBatis 的 大 致 执行 流程 ， 更 多 详细 的 内 容 可 查看 MyBatis 源码 进行 学 习 。 
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高 并 发 点 赞 项 目 实践 


本 章 主要 介绍 高 并 发 项 目的 常规 解决 方案 ，Redis 缓存 和 消息 中 间 件 MQ 的 安装 和 使 用 , 以 
及 如 何 一 步 一 步 实现 高 并 发 点 赞 项 目 。 


12.1 高 并 发 点 赞 项 目 


12.1.1 项目 概述 


在 社交 网 站 或 者 App 中 ， 点 赞 场景 非常 多 ， 比 如 微 信 说 说 点 赞 、 微 博 点 赞 、 博 文 点 赞 、 拌 
音 点 赞 等 。 普 通 人 发 的 微 信 说 说 点 赞 人 数 比较 少 ， 所 以 并 发 数 比较 少 ;而 一 些 名 人 发 的 微 博 ， 
由 于 粉丝 多 ， 可 能 一 条 微 博 在 短 时 间 内 点 赞 数 高 达 100 万 甚至 更 多 。 面 对 如 此 高 并 发 的 点 赞 ， 
如 果 项 目 设 计 没有 做 好 ， 必 将 导致 后 端 服务 器 和 数据 库 由 于 压力 过 大 程序 出 现 异 常 。 所 以 说 ， 
小 小 的 点 赞 功能 并 不 简单 。 大 型 互联 网 公司 后 端 架构 必 会 采取 很 多 措施 来 解决 这 种 高 并 发 场景 
引发 的 问题 ， 比 如 引入 缓存 提升 读 的 性 能 、 使 用 MQ 队列 进行 异步 处 理 等 。 

本 章 要 讲 的 高 并 发 点 赞 项 目 没有 复杂 的 前 端 页 面 和 业务 ， 更 多 的 是 根据 点 赞 这 个 小 功能 ， 
为 读者 深度 剖析 大 型 互联 网 公司 是 如 何 解决 高 并 发 访问 的 场景 ， 把 这 个 小 功能 揉 开 狂 碎 展现 给 
读者 ， 让 读者 学 会 处 理 高 并 发 场景 下 的 架构 设计 ， 并 应 用 到 之 后 的 工作 中 。 
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12.1.2 ”数据 库 表 和 持久 化 类 


首先 ， 根 据 高 并 发 点 赞 功 能 设计 数据 库 表 user〈 用 户 表 ) 、mood (说 说 表 ) 和 
user mood praise rel〈 点 赞 关 联 表 ) ， 有 具体 如 图 12-1 所 示 。 


Y 区 springmvc-mybatis-book 


Se 


ol 
w 了 


| ay role 
EE ay school 
国 ay_student 
国 ay user 
GB ay user address 


EE ay user role rel 一 
国 mood 一 
图 we 如 


局 user mood_praise_rel 


图 12-1 高 并 发 点 赞 数据 库 表 
创建 user 表 〈 用 户 表 ) 的 SQL 语句 如 下 所 示 : 


DROP TABLE TE EXTISTS user ， 
CREATE TABLE ‘'user' ( 

'id' varchar(32) NOT NULL AUTO INCREMENT, 

"name' varchar(20) DEFAULT NULL, 

‘account' varchar(20) DEEFAULT NULL, 

PRIMARY KEY (id 

KEY 'USer name index' ('name') USING BTREE, 

Ka USer aceount index, (account ) USING BTREE 
) ENGINE=InnoDB DEFAULT CHARSET=Uutf8; 


创建 mood 表 ( 说 说 表 ) 的 SQL 语句 如 下 所 示 : 


DROP TABLE IE EXISTS ‘mood', 

CREATE TABLE ‘mood, (人 
'id' varohart (32) NOT NULE AUTO INCREMENT, 
content varchar (256) DEFAULT NULL, 
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'User id' varchar(32) DEEFAULT NULL;, 

'publish time' datetime DEFAULT NULL, 

'praise num' int(11) DEFAULT NULL, 

PRTMARY KEY (jd'), 

KEY mood user id index” (usen iQ"') USTING BITREE 
) ENGINE=INNODB DEFAULT CHARSET=utf8; 


创建 user mood praise rel 表 ( 点 赞 关联 表 ) 的 SQL 语句 如 下 所 示 。 


CREATE TABLE 'user mood praise rel' ( 
Wd OLoLne (S32) NOP NULE AUTO INCREMENT, 
user ler varenar(32) DEEBAULD NYU, 
'mood id' varchar(32) DEFAULT NULL, 
PRIMAR Ye bY (oc ) 


KEY "USer mood praise rel Use id index, ('user id’") USTNG BTREE, 
KEY 'user mood praise rel mood id index' ('mood id') USING BTREE 
) ENGINE=InnoDB AUTO INCREMENT=2 DEFAULT CHARSET=utf8; 
user 表 的 初始 化 数据 : 
INSERT INTO 'user' VALUES ('1', 7 阿 角 "， 'ay'); 
TNSERT TNTO Ser VALUES (01277 Wh val )y 
mood 表 的 初始 化 数据 : 
INSERT INTO ‘mood，VALUES ('1',' 今 天 天 气 真 好 ',，'1',，'2018-=06-30 22:09:06', 
EOOW)S 


INSERT INTO "mood' VALUES ("2，, "厦门 真 美 ， 么 人 内!" "2 12018=07-2917:13:04", 
'991); 

其 中 ，user (用 户 表 ) 和 mood (说 说 表 ) 是 一 对 多 的 关系 ， 即 一 个 用 户 可 以 发 表 多 条 说 说 ， 
每 条 说 说 只 能 属于 一 个 用 户 。 而 user mood praise rel (点 赞 关 联 表 ) 主要 记录 user〈 用 户 表 ) 
和 mood (说 说 表 ) 的 关联 关系 ， 即 哪些 说 说 被 哪些 用 户 点 赞 。 表 之 间 的 关系 如 图 12-2 所 示 。 

数据 库 表 创建 完成 之 后 ， 在 springmvc-mybatis-book 项 目 中 创建 表 对 应 的 持久 化 对 象 。 

在 \src\main\java\com.ay.model 包 下 创建 user 表 的 持久 化 对 象 ， 具 体 代码 如 下 : 


/** 

* Qauthor Ay 

* @date 2017/9/16. 

yh 

public class User implements Serializable 


/** 
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* 主键 

2 

private String 工 Q7 
/** 

* 用 户 名 称 

*/ 

private String name; 
/** 

* 账户 

*/ 


private String account,; 


// 省 略 set、get 方法 


} 
user{ 用 户 表 } 


+ id : 主 久 
+ name : 姓名 
+ account:， 账户 


User mood praise rel (关联 表 ) 
+ Id : 主键 
+ mood id: 说 说 id 
+ Liser id: 用 户 id 


+ Id: 主 往 
+ content: 内 容 
+ User id: 用 户 id 
+ parse num; 点 


图 12-2 数据 库 表 关 系 图 
在 src\mainNjava\com.ay.model 包 下 创建 mood 表 的 持久 化 对 象 ， 具 体 代 码 如 下 : 


/** 
* Qauthor Ay 
* @date 2017/9/16. 
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i 
public class Mood implements Serializablef 

/** 

* 主键 

wh 

private String id; 

/** 

* 说 说 内 容 

Private String content; 
/大 六 

* 点 赞 数量 

A 
private Integer praiseNum; 
/** 

2 El 

< 
private String userld; 
/** 

* 发 表 时 间 

yh 
private Date publishTime; 


// 省 略 set、get 方法 
} 


在 srcmainNMavavcom.ay.model 包 下 创建 user mood praise rel 表 的 持久 化 对 象 ， 有 具体 代码 
如 下 : 


/** 
描述 :说 说 点 赞 关 联 表 


A 


* 


* Qauthor ay 
* @date 2017/9/16 
此/ 
public class UserMoodPraiseRel implements Serializable { 
/** 
x 主键 
*/ 
private String id; 


/大 类 


仅 供 非 商 业 用 途 或 交流 学 习 使 / 
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局 il 

wh 

private String userld; 
/六 大 

* 说 说 id 

A 


private String moodId; 


// 省 略 set、get 方法 


12.1.3 ”DAO 层 和 Mapper 映射 文件 


数据 库 表 和 持久 化 类 创建 完成 之 后 ， 继 续 创 建 对 应 的 Dao 类 和 Mapper 映射 文件 。 在 
src\mainyjava\com.ay. dao 包 下 创建 user 表 对 应 的 Dao 类 ， 具 体 代码 如 下 : 


/** 

* 描述 :用户 Dao 

* @author Ay 

* @create 2018/06/30 

大 类/ 

@Repository 

public interface UserDao { 
// 查 询 用 户 
User fand(String ja) 

} 


在 src\main\resources\mapper 目录 下 创建 user 表 对 应 的 Mapper 映射 文件 UserMapper.xml， 
具体 代码 如 下 : 


<?xml Version="1.0" encoding="UTF-8'" ?> 

<!DOCTYPE mapper PUBLIC "“-//mybatis.org//DTD Mapper 3.0//EN" 
"http://mybatis.org/dtd/mybatis-3-mapper.dtd"> 

<mapper namespace="com.ay.dao.UserDao"> 


<resultMap id="userMap" type="com.ay.model.User"> 
<id property="id" column="id"/> 
<result property="name" column="name"/> 
<result property="account" column="account"/> 

</resultMap> 

<1-- sql 代码 块 --> 


<sql id="table column"> 
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pvo 

name, 

account 
</sql> 


<select id="find" resultMap="userMap"> 
SELECT 
<include refid="table column"/> 
FROM user 
<where> 
id = #{id} 
</where> 
</select> 


</mapper> 


UserDao 类 中 定义 了 一 个 查询 用 户 的 方法 find0， 而 UserMapper.xml 映射 配置 文件 中 定义 了 
find() 方 法 对 应 的 select 查询 语句 ， 还 定义 了 SQL 代码 块 。 
UserDao.java 和 UserMapper.xml 文件 创建 完成 之 后 ， 接 下 来 创建 mood 表 对 应 的 Dao 层 和 


Mapper 映射 文件 。 
src\main\java\com.ay.dao\MoodDao.java 具体 代码 如 下 : 


/** 

* Qauthor Ay 

* @create 2018/06/30 

**/ 

@Repository 

public interface MoodDao 1{ 


List<Mood> findAll(); 
上 


src\main\resources\mapper\ MoodMapper.xml 具体 代码 如 下 : 


< 2xml version="1.0" encoding="UTF-8" ?2> 
<!IDOCTYPE mapper PUBLIC "-//mybatis.org//DTD Mapper 3.0//EN" 
"http://mybatis.org/dtd/mybatis-3-mapper.dtd"> 


<mapper namespace="com.ay.dao.MoodDao"> 


<resultMap id="moodMap" type="com.ay.model .Mood"> 


<id property="id" column="id"/> 
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<result property="content" column="content"/> 

Snesule ropPerby= LuUSerlidr colunm Lucene /> 

<result property="praiseNum" column="praise num"/> 

<result property="publishTime" column="publish time"/> 
</resultMap> 


Ssql ld=utab leNeolumn'> 
工 @5 
content, 
user id, 
praise num, 
publish time 
</sql> 


<select id="findAll" resultMap="moodMap"> 
SELECT 
“nolude retid= Eade oolumn /> 
FROM mood 

</select> 


</mapper> 


MoodDao 类 中 定义 了 一 个 查询 所 有 用 户 的 方法 findAll()， 而 MoodMapper.xml 映射 配置 文 
件 中 定义 了 findAll0 方 法 对 应 的 select 查询 语句 ， 还 定义 了 SQL 代码 块 。 
src\main\java\com\ay\dao\UserMoodPraiseRelDao.java 具体 代码 如 下 : 


/** 

* 描述 : 用户 说 说 点 赞 关联 DAO 
* @author RAY 

* @create 2018/07/01 

**/ 

@Repository 


public interface UserMoodPraiseRelDao { 


boolean save(@Param("userMoodPraiseRel") UserMoodPraiseRel 


userMoodPraiseRel); 
src\main\resources\mapper\UserMoodPraiseRelMapper.xml 具体 代码 如 下 所 示 : 


<?xml] version="]1.0" encoding="UTF-8" ?> 
<!DOCTYPE mapper PUBLIC "-//mybatis.org//DTD Mapper 3.0//EN" 
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"http://mybatis.org/dtd/mybatis-3-mapper.dtd"> 
<mapper namespace="com.ay.dao.UserMoodPraiseRelDao"> 
<insert id="save" useGeneratedKeys="true" keyProperty="id" 
parameterType="com.ay.model.UserMoodPraiseRel"> 
insert into user mood praise rel (user id, mood id) 
VALUE (#{userMoodPraiseRel.userId}, #{userMoodPraiseRel .moodId}) 
</insert> 


</mapper> 


UserMoodPraiseRelDao 接口 只 有 一 个 save() 方 法 用 来 保存 说 说 被 用 户 点 赞 的 记录 。 
至 此 ，Dao 类 和 Mapper 映射 文件 全 部 创建 完成 。 代 码 相对 比较 简单 ， 就 不 做 过 多 的 解释 。 


12.1.4 Service 层 和 DTO 类 


上 一 节 中 ， 已 经 在 springmvc-mybatis-book 项 目 中 创建 了 Dao 类 和 Mapper 映射 文件 ， 这 一 
节 主 要 创建 user 表 和 mood 表 对 应 的 Service 服务 层 以 及 DTO 对 象 。 
src\main\java\com.ay.dto\MMoodDTO.java 对 应 的 代码 如 下 : 


/Rx 
* 描述 : 说 说 DTO 
* @author RAY 
* @date 2018/1/6. 
7 
public class MoodDTO extends Mood { 
/** 
* 用 户 名 称 
7 


private String userName; 


/** 
* 用 户 的 账号 
3 


private String userAccount; 
// 省 略 set、get 方法 
} 
src\main\java\com.ay.dto\UserDTO.java 对 应 的 代码 如 下 : 


/** 
* 描述 : 用 户 DTO 
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* Qauthor Ay 

* @create 2018/07/01 

**/ 
public class UserDTO extends User { 


) 


MoodDTO 和 UserDTO 主要 用 于 前 端 展 示 用 的 DTO 对 象 ， 内 容 比 较 简单 ， 不 做 过 多 的 描述 。 
src\main\java\com.ay.service\UserService.java 对 应 的 代码 如 下 : 


/** 
* 描述 : 用 户 服务 接口 
* @author Ay 
* @date 2018/1/6. 
% 
public interface UserService { 
// 通 过 id 查询 用 户 
UserDTO find(String id); 
} 


src\main\java\com.ay.service\IMoodService.java 对 应 的 代码 如 下 : 


/** 
* 描述 : 说 说 接口 
* @author Ay 
* @date 2018/1/6. 
sk 
public interface MoodService { 
// 查 询 所 有 的 说 说 
List<MoodDTO> findAll (); 
} 


UserService 用 户 服务 层 只 有 一 个 方法 find()， 用 来 查询 用 户 。MoodService 说 说 服务 层 定义 


一 个 个 findAll0 方 法 ， 用 来 查询 所 有 的 说 说 。 内 容 比较 简单 ， 不 做 过 多 的 描述 。 


src\main\java\com.ay.service.impl\UserServiceImpl.java 对 应 的 代码 如 下 : 


/** 

* 描述 : 用 户 服务 类 
* Qauthor Ay 

* @date 2018/1/6. 
2 


@Service 
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public class UserServiceImpl implements UserService { 


@Resource 
private UserDao userDao; 


puUblilc UserDLIO find (Stringe jo) st 
User user = UserDao.find(id); 
return converModel2DTO (user),; 


private UserDTO converModel2DTO(User user)t{ 
UserDTO userDTO = new UserDTO(); 
userDTO.setId(user.getl1Id()); 
userDTO.setAccount (user.getAccount () ) ; 
userDTO.setName (user.getName () ) ， 


return userDTO; 


} 


UserServiceImpl 用 户 服务 实现 类 主要 是 对 UserService 接口 进行 实现 。 在 UserServiceImpl 
类 中 除了 实现 find() 方 法 ， 还 定义 了 私有 方法 用 来 把 User 对 象 转换 为 UserDTO 对 象 。 
src\main\java\com.ay.service.impl\MoodServiveImpljava 对 应 的 代码 如 下 : 


/** 

* 描述 :说 说 服务 类 

* @author Ay 

* @date 2018/1/6. 

7 

@Service 

public class MoodServiveImpl implements MoodService { 
QResource 
private MoodDao moodDao; 


@Resource 
private UserDao userDao; 


public List<MoodDTO> fingdAll() { 
// 查 询 所 有 的 说 说 
List<Mood> moodList = moodDao.findAll (); 
// 转 换 为 DTO 对 象 


return converModel2DTO (moodList); 


不 。 
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private List<MoodDTO> converMode12DTO (List<Mood> moodList){ 
if(CollectionUtils.isEmpty (moodList)) return 
Collections: 有 MRITRY LIST,; 
List<MoodDTO> moodDTOList = new ArrayList<MoodDTO>(); 
for (Mood mood:moodList)t{ 
MoodDTO moodDTO = new MoodDTO(); 
moodDTO.setId (mooaQ.getIQ() ) ， 
moodDTO.setContent (mood.getContent () ) 7 
moodDTO. setPraiseNum(mood.getPraiseNum()); 
moodDTO. setPublishTime (mood.getPublishTime()); 
moodDTO. setUserIid (mood.getUserId()); 
moodDTOList.add (moodDTO); 
// 设 置 用户 信 息 
User user = userDao.find(mood.getUserId()); 
moodDTO.setUserName (user.getName ());，; 
moodDTO.setUserAccount (user.getAccount () ) ， 
} 


return moodDTOList; 


} 


MoodServiveImpl 说 说 服务 实现 类 主要 是 对 接口 MoodServive 进行 实现 。 在 
MoodServiveImpl 类 中 除了 实现 findAll0 方 法 外 ， 还 定义 了 私有 方法 converModel2DTO(O 用 来 把 
Mood 对 象 转换 为 MoodDTO 对 象 ， 在 方法 converModel2DTO() 中 还 通过 userld 查询 每 一 条 说 说 
对 应 的 用 户 ， 然 后 把 用 户 姓 名 name 和 用 户 账号 account 设置 到 MoodDTO 对 象 ， 最 后 返回 。 这 
样 就 可 以 清楚 地 知道 每 条 说 说 有 具体 是 由 那个 用 户 发 表 的 。 

src\main\java\com\ay\service\UserMoodPraiseRelService.java 具体 代码 如 下 : 

/x* 

* 描述 : 用户 说 说 点 赞 关联 接口 
* @author RAY 

* @date 2018/1/6. 

a 


public interface UserMoodPraiseRelService ({ 


boolean save(UserMoodPraiseRel userMoodPraiseRel); 
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src\main\java\com\ay\service\impl\UserMoodPraiseRelServiceImpl.java 具体 代码 如 下 : 


J 
* 描述 : 用 户 说 说 点 赞 关联 服务 类 

* @author Ay 

* @date 2018/1/6. 

wo 

QService 

public class UserMoodPraiseRelServiceImpl implements 


UserMoodPraiseRelService 1 


@Resource 
private UserMoodPraiseRelDao userMoodPraiseRelDao; 


public boolean save (UserMoodPraiseRel userMoodPraiseRel) 1 


return userMoodPraiseRelDao.save (userMoodPraiseRel); 


12.1.5 ”Controller 层 和 前 端 页 面 


上 一 节 ， 已 经 创建 完 Service 层 和 DTO 对 象 ， 这 一 节 继 续 创 建 user 表 和 mood 表 对 应 的 


Controller 层 和 前 端 页 面 。 
src\main\java\com.ay.controller\UserController.java 对 应 的 代码 如 下 : 


/** 

* 描述 ， 用户 控 制 层 

* Qauthor Ay 

* @date 2018/6/6. 

2/ 

@RestController 

@RequestMapping ("/user") 

public class UserController { 
@Resource 


private UserService userService; 


} 
src\main\java\com.ay.controlle MoodController.java 对 应 的 代码 如 下 : 


/** 
* 描述 : 说 说 控制 层 
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* Qauthor Ay 

* @date 2018/1/6. 

wi 

@Controller 

GRequestMapping ("/mood") 
public class MoodController { 


@Resource 
private MoodService moodService; 


@RequestMapping ("/findAll") 

public String findAll (Model model) { 
List<MoodDTO> moodDTOList = moodService.findAll(); 
model.addAttribute ("moods",moodDTOList),; 


return "mood"™; 


} 

UserController 和 MoodController 是 用 户 和 说 说 对 应 的 控制 层 类 ，UserController 没有 多 少 代 
码 ， 后 续 需 要 再 开发 ， 而 MoodController 类 只 有 一 个 findAll0 方 法 用 来 查询 所 有 的 说 说 列表 。 

src\imain\webapp\WEB-INF\Wviews\mood.jsp 对 应 的 代码 如 下 : 


<%Qpage language="java" contentType="text/html; charset=UTF-8" 
pageEncoding="UTF-8" isELlignored="false"%> 
<g%Q taglib uri="http://java.sun.com/jsp/jstl/core" prefix="c"%> 
<!DOCTYPE HTML> 
<html> 
<head> 
<title>Getting Started: Serving Web Content</title> 
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8" /> 
</head> 
<body> 


<div id="moods"> 
<pb> 说 说 列表 :</b><br> 
<c:forEach items="$ {moods}" var="mood"> 
<br> 
<b> 用 户 : </b><span id="account">$ {mood.userName}</span><br> 
<pb> 说 说 内 容 : </b><span id="content">$ {mood.content}</span><br> 
<b> 发 表 时 间 : </b> 
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<span id="pubilish time"> 
${mood.publishTime} 
</span><br> 
<b> 点 赞 数 :</b><span id="praise num">$ {mood.praiseNum}</span><br> 
<div style="margin-left: 350px"> 
<a id="praise"> 赞 </a> 
</div> 
</c:forEach> 

</div> 

</body> 

<script></script> 

</html> 


mood.jsp 页 面 主要 用 来 展示 所 有 的 说 说 ， 并 提供 点 赞 功能 。 当 然 ， 这 个 功能 还 没有 开发 ， 
后 续 内 容 会 开发 这 个 功能 
12.1.6 测试 


所 有 的 代码 都 开发 完成 之 后 ， 重 新 部 署 pringmvc-mybatis-book 项 目 。 项 目 启动 成 功 之 后 ， 
在 浏览 器 输入 访问 路 径 : http://localhost:8080/mood/findAll， 便 可 以 在 浏览 器 看 到 如 图 12-3 所 示 
的 页 面 。 


用 户 : 阿 识 
说 说 内 容 : 今天 天 气 真 好 


发 表 时 间 : Sun jul 01 06:09:06 CST 2018 
点 赞 数 : 100 
锣 


图 12-3 ”说 说 页 面 


12.2 ”传统 点 赞 功能 实现 


12.2.1 概述 
对 于 初级 开发 工程 师 ， 其 实现 点 赞 功能 的 思路 如 图 12-4 所 示 。 


习 使 


非 卖 品 ， 仅 供 非 商业 用 途 或 交流 学 习 使 用 


230 | Spring MVC + MyBatis 快速 开发 与 项 目 实战 


Service 屋 


保存 说 说 点 赞 


记录 
操作 荐 "| MySQL 


数量 


图 12-4 传统 点 赞 功 能 设计 方案 


由 图 12-4 可 知 ， 用 户 在 前 端 页 面 (具体 如 图 12-5 所 示 ) 给 某 一 条 喜欢 的 说 说 点 赞 ， 点 赞 请 
求 到 达 后 端 时 ， 后 端 开启 一 个 线程 进行 处 理 ，Service 层 主 要 做 两 件 事 : 
说 说 列表 : 


用 户 : 阿 新 

说 说 内 容 ; 今天 天 气 真 好 ! 

发 表 时 间 : Sun ful 01 06:09:06 CST 2018 
点 赞 数 : 117 


用 户 : 阿兰 

说 说 内 容 : 厦门 真美 ， 么 么 号 ! 
发 表 时 间 : Mon Jul 30 01:13:04 CST 2018 
点 赞 数 : 99 


12-5 说 说 页 面 


(1) 保存 点 赞 用 户 与 被 点 赞 说 说 的 关联 关系 ， 该 关系 保存 在 user_ mood_praise rel 这 张 
表 中 。 
(2) 更 新 被 点 赞 说 说 的 点 赞 数量 。 


Service 层 处 理 过 程 中 ， 请 求 数据 库 获 取 连 接 ， 执 行 相关 的 数据 库 操作 后 归还 数据 库 连接 或 
者 杀 掉 数据 库 连接 (备注 : 取决 于 是 否 配 置 数 据 库 连接 池 ) ， 最 终 返 回 数据 给 用 户 。 

通过 上 述 分 析 ， 能 够 清楚 地 知道 ， 在 高 并 发 情况 下 ， 比 如 胡 歌 发 表 一 条 热门 说 说 : “今天 
我 结婚 啦 ”， 在 半 个 小 时 内 说 说 点 赞 数 量 高 达 20 万 ， 那 么 QPS 高 达 111 (QPS = 每 秒 请 求 数 / 
事务 数量 ) ， 也 就 是 后 端 服务 每 秒 要 创建 111 个 线程 来 处 理 点 赞 请 求 ， 而 每 次 请 求 需要 创建 数 
据 库 连接 或 者 从 数据 库 连接 池 获 取 连 接 。 我 们 都 知道 ， 数 据 库 的 连接 数量 是 有 限 的 ， 这 么 高 的 
线程 请 求 数 和 数据 库 连 接 数 对 服务 器 来 说 压力 非常 大 ， 会 导致 服务 器 响应 时 间 长 ， 处 理 缓 慢 甚 
至 宕 机 。 这 就 是 传统 实现 所 带 来 的 隐患 和 弊端 。 


LD 
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12.2.2 ”代码 实现 


分 析 完 传统 点 赞 功能 实现 的 基本 思路 和 步骤 后 ， 我 们 来 简单 地 实现 它 。 有 具体 步骤 如 下 所 示 。 
在 srcwainNesources\mapperMoodMapper.xml 文件 中 添加 如 下 代码 : 


<select id="findById" resultMap="moodMap"> 
select 
<include refid="table column/> 
from mood 
<where> 
id = #{id} 

</where> 

</select> 


<update id="update"> 
update mood 
<SeE> # 
<if test="mood.content != null and mood.content != ''"> 
content = #{mood.content}, 
E> 
<if test="mood.praiseNum != null and mood.praiseNum != ''"> 
praise num = #{mood.praiseNum}, 
/EES ; 
</set> 
WHERE id = #{mood.id} 
</update> 


findById 查询 用 来 根据 id 查询 说 说 实体 mood，update 方 法 主要 用 来 更 新 说 说 数据 。 代 码 比 
较 简 单 ， 就 不 过 多 资 述 。 
在 src\mainjava\com\ay\dao\IMoodDao.java 文件 中 添加 如 下 代码 : 


/x** 

* 描述 ， 用户 Dao 

* Qauthoz Ay 

* Qcreate 2018/06/30 

大 大 / 

@Repository 

public interface MoodDao { 
boolean update (@Param ("mood") Mood mood); 
Mood findById(String id); 
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在 srcvmainNjavavcomay\service\MoodService.java 文件 中 添加 如 下 代码 : 


人 
* 描述 : 说 说 接口 
* Qauthor Ay 
* @date 2018/1/6. 
RN/ 
public interface MoodService { 
// 传 统 点 赞 
boolean PraiseMood (String userId, String moodId); 
boolean update (@Param("mood") Mood mood); 
Mood findById (String id); 
} 


MoodService 接口 主要 添加 三 个 方法 : praiseMood() 处 理 用 户 点 赞 、update() 更 新 说 说 数 


据 、findByIdO 根 据 id 查询 说 说 。 


在 src\main\java\com\ay\service\impl\MoodServiveImpl.java 文件 中 添加 如 下 代码 : 


/** 
* 描述 : 说 说 服务 类 
* Qauthor Ay 
* @date 2018/1/6. 
wy 
@Service 
public class MoodServiveImpl implements MoodService { 
@Resource 
private MoodDao moodDao; 
@Resource 
private UserDao userDao; 
@Resource 
private UserMoodPraiseRelDao userMoodPraiseRelDao; 


// 省 略 代码 


public boolean praiseMood(String userId，String moodId) { 
// 保 存 关联 关系 
UserMoodPraiseRel userMoodPraiseRel = new UserMoodPraiseRel ();，; 
userMoodPraiseRel.setUserId (userId); 
userMoodPraiseRel .setMoodId (moodId); 


userMoodPraiseRelDao.save (userMoodPraiseRel); 


仅 供 非 商 业 用 途 或 交流 学 习 使 / 
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// 更 新 说 说 的 点 赞 数量 
Mood mood = this.findById (moodId); 
mood.setPraiseNum(mood.getPraiseNum() + 1): 


this.update (mood); 


return Boolean.TRUE; 


public boolean update (Mood mood) { 
return moodDao.update (mood) ， 


publnonMood ny (St sc) 
return moodDao.findByld(id); 


} 


MoodServiveImpl 实现 MoodServive 接口 中 的 praiseMoodO、update0 和 findById() 方 法 。 
在 srcmainNjavavcomay\controllerMoodController.java 文件 中 添加 如 下 代码 : 


/** 

* 描述 :说 说 控制 层 

x @author Ay 

* @date 2018/1/6. 

A 

@Controller 

@RequestMapping ("/mood") 
public class MoodController { 


@Resource 
private MoodService moodService; 


// 和 省 略 代码 


@GetMapping (value = "/{moodId}/praise") 
public String praise(Model model, @PathVariable (value="moodId") 
String moodId,@RequestParam(value="userId")String usezId) { 


boolean isPraise = moodService.praiseMood(userId, moodIid); 


List<MoodDTO> moodDTOList = moodService.findAll (); 
model.addAttribute ("moods",moodDTOList); 
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model .addAttribute ("isPraise", isPraise); 


return “mood"™; 


} 
在 src\main\Wwebapp\WEB-INF\views\mood.jsp 文件 中 添加 如 下 代码 : 


<%Qpage language="java" contentType="text/html; charset=UTF-8" 
pageEncoding="UTF-8" isELIgnored="false"%®> 

<%@ taglib uri="http://java.sun.com/jsp/jstl/core" prefix="c"%> 
<g%Q taglib prefix="fmt" uri="http://java.sun.com/jstl/fmt" %> 
<!DOCTYPE HTML> 
<html> 
<head> ; 

<title>Getting Started: Serving Web Content</title> 

<meta http-equiv="Content-Type" content="text/html; charset=UTF-8" /> 
</head> 
<body> 


<div id="moods"> 
<b> 说 说 列表 :</b><br> 
<C:forEach items="${moods}" var="mood"> 
<br> 
<b> 用 户 : </b><span id="account">${mood.userName}</span><br> 
<b> 说 说 内 容 : </b><span id="content">${mood.content}</span><br> 
<b> 发 表 时 间 : </b> 
<span id="publish time"> 
$ {mood.publishTime} 
</span><br> 
<b> 点 赞 数 : </b><span id="praise num">$ {mood.praiseNum}</span><br> 
<div style="margin-left: 350px"> 
<!-- 重 点 ， 每 次 点 赞 都 会 向 后 端 发 起 请 求 ， 并 把 请 求 参数 moodId 和 userId 传递 给 后 端 --> 
<a id="praise" href="/mood/$ {mood.id}/praise?userId= 
${mood.userId}"> 赞 </a> 
</div> 
</c:forEach> 
</div> 
</body> 
<script></script> 
</html> 


仅 供 非 商 业 用 途 或 交流 学 习 使 用 


第 12 章 高 并 发 点 赞 项 目 实践 | 235 


12.2.3 测试 


代码 开发 完成 之 后 ， 重 新 启动 项 目 springmvc-mybatis-book， 在 浏览 器 中 输入 请 求 URL: 
http://localhost:8080/mood/findAll 时 ， 后 端 会 返回 所 有 的 说 说 数据 给 前 端 展示 ， 具 体 如 图 12-6 所 示 。 


说 说 内 容 : 今天 天 气 真 好 ! 说 说 内 容 : 今天 天 气 真 好 ! 


发 表 时 间 : Sun Jul 01 06:09:06 CST 2018 发 表 时 间 : Sun Jul 01 06:09:06 CST 2018 
点 赞 数 : 117 一 一 出 点 赞 数 : 119 一 | 


图 12-6 说 说 列表 页 面 
单 击 赞 功 能 ， 发 现 说 说 点 赞 的 数量 会 不 断 地 增加 ， 同 时 在 数据 库 表 user_mood_praise_rel 
中 ， 可 以 查询 到 相关 的 关联 数据 。 当 然 这 里 的 点 赞 功能 允许 同一 个 用 户 对 同一 条 说 说 进行 多 次 
点 赞 ， 在 真实 的 场景 下 是 不 允许 的 ， 比 如 微 博 、 微 信 等 。 我 们 只 是 为 了 开发 方便 ， 重 点 是 掌握 
解决 高 并 发 点 赞 功 能 的 思路 和 办 法 。 


12.3 ”集成 Redis 缓存 


12.3.1 概述 
传统 的 点 赞 功能 实现 暴露 的 问题 是 很 明显 的 ， 主 要 有 : 


(1) 高 并 发 请 求 下 ， 服 务 器 频繁 创建 线程 。 

(2) 高 并 发 请 求 下 ， 数 据 库 连接 池 中 的 连接 数 有 限 。 

(3) 高 并 发 请 求 下 ， 点 赞 功能 是 同步 处 理 等 。 

传统 的 点 赞 功能 ， 性 能 瓶颈 主要 在 第 (2) 和 (3) 条 ， 第 (1) 条 问题 不 可 避免 。 针 对 传统 
的 点 赞 功能 实现 所 带 来 的 一 系列 问题 ， 我 们 引入 Redis 缓存 。 每 次 点 赞 请 求 不 是 直接 和 MySQL 
数据 库 进行 交互 ， 而 是 直接 和 Redis 缓存 服务 器 进行 交互 ， 即 把 点 赞 相关 的 数据 保存 到 Redis 组 
存 ， 最 后 通过 Quartz 创建 定时 计划 ， 再 把 缓存 中 的 数据 保存 到 数据 库 。 有 具体 解决 方案 如 图 12-7 
所 示 。 
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Service 屋 


| 


保存 说 说 点 赞 记录 | L_ a 
ee 到 Redis 缓存 中 | (asaf | 


1 
1 | 更 新 说 说 点 灶 数 是 | 1 

MySQL 数据 库 = 一 ! 
1 

i 


图 12-7 引入 Redis 缓存 设计 方案 


12.3.2 ”Redis 安装 和 使 用 


Redis 是 一 个 基于 内 存 的 ， 单 线程 高 性 能 key-value 型 数据 库 ， 读 写 性 能 优异 。 和 
Memcached 缓存 相 比 ，Redis 支持 丰富 的 数据 类 型 ， 包 括 string (字符 串 ) 、list (链表 ) 、set ( 集 
合 ) 、zset (sorted set 有 序 集合 ) 和 hash〈 哈 希 类 型 ) 。 因 此 Redis 在 企业 中 被 广泛 使 用 。 

Redis 项 目 本 身 不 支持 Windows， 但 是 Microsoft 开放 技术 小 组 开发 和 维护 这 个 Windows 
端口 (针对 Win64) 。 所 以 我 们 可 以 在 网 络 上 下 载 Redis 的 Windows 版 本 。 有 具体 步骤 如 下 : 


1 打开 官网 http:/redis.io/， 单 击 Download， 具 体 如 图 12-8 所 示 。 


“redis commands cients Documentation Community 


Redis is sn open source (BSD licensed), in-memory data Structure store, used as a database, 
cache and message broker. It supports data structures such as strings, hashes, lists, sets, 
sorted sets with range Que aps, hyperloglogs and geospatial indexes with radius 
queries. Redis has built-in replication, Lua scripting, LRU eviction, transactions and different 
levels of on-disk pe snce， rovides high availability via Redis Sentinel and automatic 


partitioning with Redis Cluster i 


Tryit Quick links 


Ready for 3 


图 12-8 Redis 下 载 首页 
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ED2 在 弹出 的 页 面 中 ， 找 到 Leam more 选项 ， 并 单 击 进 入 ， 具 体 如 图 12-9 所 示 。 


Other versions 


Old (3.2) 


Redis 3.2 is the previous stable release. Does not include all the improve 
tested release, probably a good pick for critical applications while 4.0 mat 
See the release niotes or download 3.2.11， 


Windows Es 
The Redis project does not officially support We Micr 


maintains this Windows port targeting Win64, Learn more 


12-9 ”点 击 Learn more 链接 
“03 在 弹出 的 页 面 中 选择 【releases】 选 项 ， 具 体 如 图 12-10 所 示 。 


clo Ne /redis 


forkad from ontire 


《> Code jssbes B+ Poll requests 了 projects 10 Wiki 


Redis is an in-memory database that persists on disk, The data modei is key-value, 
supported: Strings, Lists, Sets, Sorted Sets, Hashes http:/fredis.io 


(BD 5056 commits 20 branches © 37 releases 


12-10 选择 Download ZIP 下 载 Redis 


人 04 在 弹出 的 界面 中 选择 Redis3.0.504 这 个 版 本 ， 选 择 其 他 版 本 也 可 以 ， 单 击 
ep 下 载 Redis 安装 包 ， 如 图 12-11 所 示 。 


3.0.504 


"eolieomior rolooned 直 


This is a eritical bug fix release for Recdis on Windows 3 有 

you are toring a previous version of 30 3n a cluster configuration you should upgrade to 3.0,504 
Gryently. 

The fix rescives a problem with the duster fai-over procedure, 


This released 1 based on antireztredis 3.0.5 plus Windows-spechc fixes, 


Sep the release notes for detoils. 


Downloads 


(Redis-x64-36 504 ms 
CO Redis-x64-3.0.5045ip A 
BD source code (ip 


Wi Gotee rode tara 


图 12-11 下 载 Redis 3.0.504 安装 包 
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外 05 解压 下 载 的 安装 包 【Redis-x64-3.0.504.zip】， 双 击 【redis-serverexe】，Redis 服务 
就 运行 起 来 了 ， 如 图 12-12 所 示 。 同 时 我 们 可 以 看 到 Redis 启动 成 功 的 界面 ， 如 图 12-13 所 示 。 


2 EventLog.di 


DRedis on Windows Release Notes.docx 2 


Redis on Windows.docx 
) redis.windows.conf 
, redis.windows-service.conf 
生 redis-benchmark.exe 
j redis-benchmark.pdb 
sa redis-check-aof.exe 
Jredis-check-aofpdb 
redis-check-dump.exe 
Jredis-check-dump.pdb 
ii redis-cli.exe 
了 redis-clLpdb dll 
I redis-server.exe 
ji redis-server.pdb 


WS Windows Service Documentation.docx 


图 12-12 启动 redis 服务 器 


图 12-13 redis 启动 成 功 界面 


Redis 安装 成 功 之 后 ， 可 以 在 安装 包 里 找到 Redis 客户 端 程序 redis-cli.exe， 如 图 12-14 所 
示 ， 双 击 redis-cli.exe， 打 开 Redis 客户 端 界面 ， 如 图 12-15 所 示 。 
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\Downioads\Redis-x64-3.0.504\redis-cii.exe 


Eredis-check-aofexe 


| redis-check-aof.pdb 


redis-check-dump.exe 
| redis-check-dump.pdb 
| redis-cli.exe 
redis-clipdb 


MW redis-server.exe 


| redis-server.pdb 


“| Windows Service Documentation.docx 2016/7/3 9;37 


图 12-14 启动 Redis 客户 端 图 12-15 ”Redis 启动 成 功 界面 


下 面 就 使 用 Redis 客户 端 对 Redis 的 几 种 数据 类 型 做 基本 的 增删 改 查 操作 练习 ， 具 体 代 码 
如 下 : 
字符 串 类 型 的 增删 改 查 ; 


### 增 加 一 个 值 key 为 name，value 为 ay 
127.0.0.1:6379> set name "ay' 
OK 

### 查 询 name 的 值 

L207 NO O39 getenanme 

"ayn 

### 更 新 name 的 值 为 al 
127.0.0.1:6379> set name al: 
OK 

### 查 询 name 的 值 

L227 080 1:03N> oet name 

maln 

### 删 除 name 的 值 
L127.0.0.1:6379> del. name 
(integer) 1 

### 查 询 是 否 存 在 name，0 代表 不 存在 
127.0.0.1:6379> exists name 
(integer) 0 

2 Or OD 


List 集合 的 增删 改 查 ; 


### 添 加 key 为 usez list，value 为 "ay" al" 的 1ist 集 合 
T2700OR L009 lpuSh ser SET 
(integer) 2 

### 查 询 key 为 user 1ist 的 集合 

To OO Srangemu er ls 
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Bea 

2 

### 往 1ist 尾部 添加 love 元 素 

2 TO O09> PusSh UUSEE SEE OVE 
(integer) 3 

### 往 List 头 部 添加 hope 元 素 
P20 0 lS > uh sent hope 
(integer) 4 

### 查 询 key 为 user 1ist 的 集合 
oO Or 0d range ser st 0 下 


1 NOPE 
2 USE 
8) NA 
4) "love" 


### 更 新 index 为 0 的 值 

L270 O03 LSet USere list 0 wish, 
OK 

### 查 询 key 为 user _1ist 的 集合 
200 SN > Erange USer SEO 


ST 
2) al 
3) VayvYy 
4) "love" 


### 删 除 index 为 0 的 值 

E297 0% 0 T0392 Lremauser sist OF Wi SHY 
(integer) 1 

### 查 询 key 为 user 1ist 的 集合 
B20 0 0S/ 9> lrange USere St 0 二 于 
Sade 

2 a 

3) OVe 

272 OO G39> 


Set 集合 的 增删 改 查 : 


### 添 加 key 为 user setvvalue 为 "ay" "al" "love" 的 集合 
U0 0 O39 Sado USersSset ev Vo OW 
(integer) 3 

### 查 询 key 为 user set 集合 

L270 OT 6379> smembers USer Set 

sa 
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2 

3)0 TOVer 

### 朋 除 value 为 1ove， 返 回 1 表示 删除 成 功 ，0 表示 失败 
T2700 1 ;637190> srem USer SeEt LOVE 
(integer) 1 

### 查 询 set 集合 所 有 值 

1 20 O80 1:6379> smembers USer set 

1 el 

2 

### 深 加 love 元 素 ，set 集合 是 没有 顺序 的 ， 所 以 无 法 判断 添加 到 那个 位 置 
1 2 00 6379> sadd? USer Set ovVex 
(integer) 1 

### 查 询 set 集合 所 有 值 ， 发 现 添加 到 第 二 个 位 置 
127.0.0.1:6379> smembers User set 


1 ) ad 
2 Ove 
3) Wayn 


#### 添 加 love 元 素 ， 由 于 set 集合 已 经 存在 ， 返 回 0 代表 添加 不 成 功 ， 但 是 不 会 报错 
270 01:6379> sadd User set “Tove, 
(integer) 0 


Hash 集合 的 增删 改 查 : 


### 清 除数 据 库 

To OO 609 flushdb 

OK 

### 创 建 hash，key 为 user hset, 字 段 为 user1， 值 为 ay 
127.0.0.1:6379> hset user hset "user1"” "ay" 
(integer) 1 

### 往 key 为 user_hset 添加 字段 为 user2， 值 为 al 
127.0.0.1:6379> hset user hset "User2” “al” 
(integer) 1 

### 查 询 user hset 字段 长 度 

127.0.0.1:6379> hlen user hset 

(integer) 2 

### 查 询 user hset 所 有 字段 

127-0.0.1:6379> nkeys user hset 

1) userT 

2) JUSEn2Y 

### 查 询 user hset 所 有 值 

T2700 16379> hvals Use hset 
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2) 各 吉村 


### 查 询 字 段 user1l 的 值 

E27 0m0 -00/9> nget UUSeenSeee vsenl 
"mayn 

### 获 取 key 为 user hset 所 有 的 字段 和 值 

B27 0 0 :0379> hgetall USer hset 

1) "userl" 


0) a 
9) Ser2Y 
4) A 


### 更 新 字段 userl 的 值 为 new_ay 

L200 L089> hset User nset Vuser “newnayy 
(integer) 0 

### 更 新 字段 user2 的 值 为 new_al 

Lo O00/ DNset user hset USer2 Newe a 
(integer) 0 

### 获 取 key 为 user hset 所 有 的 字段 和 值 

20 O00 1 6039> ngetalassuser hset 

De Ser Ls 

2 EW Av, 

3 USer2 

Ad) OW el 

### 删 除 字 段 userl 和 值 

L210.0.1:63/9> hael User hset userl 

(integer) 1 

### 获 取 key 为 user hset 所 有 的 字段 和 值 

12 大 020.1:6379> hgetall user hset 

1) "user2" 

2 SWE 

L207 OO TL: 6379> 


SortedSet 集合 的 增删 改 查 : 


### 清 除数 据 库 

T2000 T6379> 下 Tshdb 

OK 

###SortedSet 集合 添加 ay 元素， 分数 为 1 

P27 OO NOS o> Zaddmusern ZSCEt Sl Lavy 
(integer) 1 

###SortedSet 集合 添加 al 元 素 ， 分 数 为 2 
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Pov/ Om O09 sadderuSserszoset 2 a 
(integer) 1 

###SortedSet 集合 添加 love 元 素 ， 分 数 为 3 

U2 OR O00> Zadd Ser ZSete Sm love, 
(integer) 1 

### 按 照 分 数 由 小 到 大 查询 user zset 集合 元 素 

To OOR EE Od/ Anges usSer Sote0 一 站 


1) WY 
2) wal"™ 
3 Ove 


### 按 照 分 数 由 大 到 小 查询 user zset 集合 元 素 
EO OL: 03/9> Zrevrange USer ZSet 人 有一 上 
1) "love" 

Ra 

SD 

### 查 询 元 素 ay 的 分 数值 

T2700 E050> ZSCore USer SoE YY ave 
mn 

### 查 询 元 素 love 的 分 数值 

HO OR 00/9 > ZSCOrLen SS Elomey 
Hie 


12.3.3 ”集成 Redis 缓存 
在 SSM 框架 中 集成 Redis 缓存 ， 首 先 需要 在 pom.xml 文件 中 引入 所 需 的 依赖 ， 具 体 代码 


如 下 : 
<properties> 
<spring.redis.version>1.6.0.RELEASE</spring.redis.version> 
<jedis.version>2.7.2</jedis.version> 
<commons .version>2.4.2</commons .version> 
</properties> 
<1!-- 集成 redis --> 
<dependency> 
<groupId>org.springframework.data</groupId> 
<artifactId>spring-data-redis</artifactId> 
<version>${spring.redis.version}</version> 
</dependency> 
<dependency> 


<groupId>org.apache.commons</groupId> 
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<artifactId>commons-pool2</artifactId> 
<version>${commons.version}</version> 
</dependency> 
<dependency> 
<groupId>redis.clients</groupId> 
<artifactId>jedis</artifactId> 
<version>${jedis.version}</version> 


</dependency> 


在 pom 文件 引入 Redis 所 需 的 依赖 之 后 ， 还 需要 在 sre\main\resources 目录 下 创建 
redis.properties 文件 并 添加 如 下 的 配置 信息 : 


redis.maxIdle=300 
redis.minIdle=100 
redis.maxWaitMillis=3000 
redis.testOnBorrow=true 
redis.maxTotal=500 

// 服 务 器 id 地 址 

RELSe OSE=T2/.0. 0 
// 链 接 端 口 ， 默 认 6379 
redis.port=6379 

//redis 密码 默认 为 空 


redis.password= 


在 srcvmainNesources 目录 下 创建 spring-redis.xml 配置 文件 并 添加 如 下 配置 信息 : 


<?2xml] version="1.0" encoding="UTF-8"?> 
<beans xmlins="http://www.springframework.org/schema/beans" 
xmlns:xsi="http://www.w3.0rg/2001/XMLSchema-instance" 
xmlns:p="http://www.springframework.org/schema/p" 
xmlns:tx="http://www.springframework.org/schema/tx" 
xmlns:context="http://www.springframework.org/schema/context" 
xSsi:schemaLocation=" 
http://www.springframework.org/schema/beans 
http://www.springframework.org/schema/beans/spring-beans-3.0.xsd 
http://www.springframework.org/schema/tx 
http://www.springframework.org/schema/tx/spring-tx-3.0.xsd 
http://www.springframework.org/schema/context 
http://www.springframework.org/schema/context/spring-context-3.0.xsd"> 


<context:property-placeholder location="classpath:*.properties"/> 


<!-- 设 置 redis 连接 池 --> 


Lm 
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<bean id="poolConfig" class="redis.clients.jedis.JedisPoolConfig"> 
<property name="maxldle" value="$ {redis.maxIldle}"></property> 
<property name="minIdle" value="${redis.minIidle}"></property> 
<property name="maxTotal" value="${redis.maxTotal}"></property> 
<property name="maxWaitMillis" 
value="$ {redis.maxWaitMillis}"></property> 
<property name="testOnBorrow" 
value="$ {redis.testOnBorrow}"></property> 
</bean> 
<1-- 链 接 redis--> 
<bean id="connectionFactory" 
class="org.springframework.data.redis.connection.jedis. 
JedisConnectionFactory"> 
<property name="hostName" value="${redis.host}"></property> 
<property name="port" value="${redis.port}"></property> 
<property name="password" value="${redis.password}"></property> 
<property name="poolConfig" ref="poolConfig"></property> 
</bean> 
<! 一 - redis 工具 类 --> 
<bean id='"redisTemplate" 
class="org.springframework.data.redis.core.RedisTemplate" 
p:connection-factory-ref="connectionFactory" > 
</bean> 
</beans> 


在 src\main\resources\applicationContext.xml 配置 文件 中 导入 spring-redis.xml 配置 ， 具 体 代 
码 如 下 : 


<import resource="spring-redis.xml"/> 


所 有 的 配置 文件 添加 完成 后 ， 在 srcemain\test\com\ay\test 目录 下 创建 测试 类 
RedisTestjava， 有 具体 代码 如 下 : 


/xx redis 缓存 测试 

* Qauthor Ay 

* @create 2018/07/08 

火炎 / 

public class RedisTest extends BaseJunit4Test{ 
@Resource 
private RedisTemplate redisTemplate; 


QTest 
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Public void testRedis(){ 
zedisTemplLate.oPsEForValue () .set ("name", "ay"™); 
String name = (String) redisTemplate.opsForValue() .get ("name"); 


System.out.printlin("value of name is:" + name); 


} 


RedisTemplate 和 StringRedisTemplate 都 是 Spring Data Redis 为 我 们 提供 的 两 个 模板 类 用 来 
对 数据 进行 操作 ， 其 中 StringRedisTemplate 只 针对 键 值 都 是 字符 串 的 数据 进行 操作 。 在 应 用 启 
动 的 时 候 ，Spring 会 初始 化 这 两 个 模板 类 ， 通 过 @Resource 注解 注入 即 可 使 用 。 

RedisTemplate 和 StringRedisTemplate 除了 提供 opsForValue 方法 用 来 操作 简单 属性 数据 之 
外 ， 还 提供 了 以 下 其 他 主要 数据 的 访问 方法 : 


(1) opsForList 操作 含有 list 的 数据 。 

(2) opsForSet 操作 含有 set 的 数据 。 

(3) opsForZSet 操作 含有 ZSet (有 序 set) 的 数据 。 
(4) opsForHash 操作 含有 hash 的 数据 。 


当 数 据 存放 到 Redis 的 时 候 ， 键 key) 和 值 (value) 都 是 通过 Spring 提供 的 Serializer 序 
列 化 到 数据 库 的 。 RedisTemplate 默认 使 用 JdkSerializationRedisSerializer ， 而 
StringRedisTemplate 默认 使 用 StringRedisSerializer。 

RedisTest 开发 完成 后 ， 运 行 测试 类 RedisTest 的 ”pga 379> get name 
testRedis() 方 法 ， 找 到 Redis 客户 端 程序 redis-cli.exe， 当 在 客 : 
户 端 输入 命令 : “get name” 后 可 以 获取 到 值 ， 同 时 可 以 
在 IDEA 控制 台中 看 到 打印 的 信息 ， 表 示 SSM 框架 成 功 地 集 
成 了 Redis 缓存 。 具 体 如 图 12-16 和 图 12-17 所 示 。 


:33,091 


11:23:33,092 DEBUG RedisConnectionUtils:125 — Opening Red 


DEBUG RedisConnectionUtils: 


- Closing Red 


11:23:33,096 DEBUG RedisConnectionUtils:205 - Closing Red 


value of name is:ay de 
11:23:33,099 DEBUG AbstractDirtiesContextTestExecutionLis 
11:23:33,101 DEBUG AbstractDirtiesContextTestExecutionLis 
33,103 


INFO GenericApplicationContext:989 — Closi 


图 12-17 控制 台 打 印信 息 


12.3.4 设计 Redis 数据 结构 
高 并 发 点 赞 项 目的 Redis 数据 结构 采用 多 个 Set 类 型 的 集合 来 存放 ， 上 具体 如 图 12-18 所 示 。 


LD 
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Key Value (mood id) 


Value (user id) 


Key (moog id) 


Set 


Set 


图 12-18 ”Redis 数据 结构 设计 


首先 ， 用 一 个 Set 集合 来 存放 所 有 被 点 赞 的 说 说 id，key 可 以 是 自己 约定 的 全 局 唯一 的 key 
即 可 ， 而 value 为 所 有 被 点 赞 的 说 说 id (mood id) 。 然 后 用 n 个 set 集合 来 存放 每 条 说 说 被 哪些 
用 户 点 赞 的 记录 。 如 图 12-18 所 示 ，mood id = 1 被 用 户 id = {2，3，4} 点 赞 ，mood id = 2 被 用 
户 id= {3} 点 赞 。 如 果 需 要 获取 某 个 mood_id 被 点 赞 的 次 数 ， 只 需要 统计 set 集合 的 size() 即 可 。 
通过 上 面 的 redis 数据 结构 设计 ， 基 本 可 以 满足 我 们 的 需求 。 


12.3.5 ”代码 实现 
在 src\main\java\com\ay\service\IMoodService.java 文件 中 添加 如 下 代码 : 


/** 

* 描述 : 说 说 接口 

* Qauthor RAY 

* @date 2018/1/6. 

2 

public interface MoodService { 


// 省 上 略 代码 


boolean praiseMoodForRedis (String userid, String moodId) ， 
List<MoodDTO> findAllForRedis () ; : 
} 
在 MoodService 接口 中 添加 两 个 方法 : praiseMoodForRedis() 和 findAllForRedis()。 
praiseMoodForRedis() 用 来 把 说 说 点 赞 的 记录 保存 到 Redis 缓存 中 ，findAllForRedis() 用 来 查询 所 
有 的 说 说 列表 ， 包 括 从 缓存 中 查询 说 说 被 点 赞 的 次 数 。 


全 
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在 src\main\java\com\ay\service\impl\MoodServiveImpl.java 文件 中 添加 如 下 代码 : 


/** 

* 描述 : 说 说 服务 类 

* Qauthor RAY 

* @date 2018/1/6. 

yA 

@Service 

public class MoodServiveImpl implements MoodService { 
// 省 略 代码 
QResource 
private RedisTemplate redisTemplate; 
//key 命名 规范 : 项 目 名 称 + 模块 名 称 + 具体 内 容 
private static final String PRATSE HASH KEY = 


"springmv.mybatis.boot.mood.id.list.key"; 


public boolean praiseMoodForRedis(String userlId, String moodId) 1{ 
//1 .存放 到 set 集合 
redisTemplate.opsForSet().add (PRAISE HASH KEY , moodId); 

//2 .存放 到 set 中 
redqisTemplate.opsEForgSet() .add (moodId,userId) ， 
return false; 


@Resource 


private UserService userService; 


public List<MoodDTO> findAllForRedis() { 
List<Mood> moodList = moodDao.findAll (); 
if (CollectionUtils.isEmpty (moodList))t 
return COllect rionmsmaiMp ey LES 
} 
List<MoodDTO> moodDTOList = new ArrayList<MoodDTO> (); 
for (Mood mood: moodList)!{ 
MoodDTO moodDTO = new MoodDTO(); 
moodDTO.setIid (mood.getId()); 
moodDTO.setUserId (mood.getUserId()); 
//right = 总 点 赞 数量 : 数据 库 的 点 赞 数量 + redis 的 点 赞 数 量 
moodDTO. setPraiseNum(mood.getPraiseNum() + 
redisTemplate.opsForSet().size (mood.getId()) .intVvalue()); 
moodDTO.setPublishTime (mood.getPublishTime ()); 
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moodDTO.setContent (mood.getContent () ) ， 
// 通 过 userID 查询 用 户 


User user = UserService.find(mood.getUserId() ) : 


WEN 


moodDTO.setUserName (user.getName ()); 


// 账 户 


moodDTO.setUserAccount (user.getAccount () ) ; 
moodDTOList.add (mooaDTO) ， 
} 


return moodDTOList,; 


} 
MoodServiveImpl 类 主要 实现 MoodServive 接口 中 的 praiseMoodForRedis() 和 
findAllIForRedis() 方 法 。 在 praiseMoodForRedis(0) 方 法 中 ， 处 理 逻 辑 比较 简单 : 


(1) 保存 mood id 到 Set 集合 中 。 
(2) 保存 mood_ id 和 点 赞 的 user_ id 到 Set 集合 中 。 


注意 , 这 里 的 Set 集合 不 是 同一 个 ， 而 是 分 开 存储 的 。 有 多 少 条 说 说 被 点 赞 ， 在 Redis 缓存 
中 就 存在 多 少 个 Set 集合 ， 每 条 说 说 的 点 赞 记录 分 别 用 一 个 Set 集合 存储 ， 这 样 可 以 保证 每 个 
Set 集合 所 占 空间 不 会 过 大 ， 同 时 在 查询 和 统计 的 时 候 ， 处 理 速度 也 会 比较 快 。 

在 srcmainNjavavcomay\controllerMoodController,java 文件 中 添加 如 下 代码 : 


/x** 
* 描述 :说 说 控制 层 

* Q@author Ay 

* @date 2018/1/6. 

wh 

QController 

@RegquestMapping ("/mood") 
public class MoodController { 


@Resource 
private MoodService moodService; 


// 省 略 代码 
QGetMapping(value = "/{moodIid}/praiseForRedis") 


public String praiseForRedis(Model model, Q@PathVariable 
(value="moodId")String moodId, 
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@RequestParam(value="userId") String userIQ) { 
// 方 便 使 用 ， 随 机 生成 用 户 id 
Random random = new Random(); 
userId = random.nextInt (100) + "> 


boolean isPraise = moodService.praiseMoodForRedis (userId, moodId); 
// 查 询 所 有 的 说 说 数据 

List<MoodDTO> moodDTOList = moodService.findAllForRedis(); 
model.addAttribute ("moods",moodDTOList); 
model.addAttribute("isPraise", isPraise); 


return “mood"™; 


} 


MoodController 主要 是 控制 层 的 代码 ， 用 来 接收 前 端的 点 赞 请 求 。 如 下 代码 主要 是 为 了 随 
机 生成 user_id， 然 后 给 菜 一 条 说 说 点 赞 。 纯 粹 是 为 了 简化 逻辑 而 开发 的 ， 在 真实 的 项 目 中 并 不 
是 这 样 的 逻辑 。 

// 方 便 使 用 ， 随 机 生成 用 户 id 


Random random = new Random();} 
userld = random.nextInt (100) + "01; 


在 src\main\webapp\WEB-INF\views\mood.jsp 文件 中 添加 如 下 代码 : 


<SQ@page language="java" contentType="text/html; charset=UTF-8" 
pageEncoding="UTF-8" isELIgnored="false"%> 

<%@ taglib uri="hnttp;//java.sun.com/jsp/jstl/core" prefix="c"%> 
<%@ taglib prefix="fmt" uri="http://java.sun.com/jstl/fmt" %> 
<1DOCTYPE HTML> 
<html> 
<head> 

<title>Getting Started: Serving Web Content</title> 

<meta http-equiv="Content-Type" content="text/html; charset=UTF-8" /> 
</head> 
<body> 


<div id="moods"> 
<b> 说 说 列表 :</b><br> 
<c:forEach items="${moods}'" var="mood"> 


<or> 
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<b> 说 说 内 容 : </b><span id="content">$ {mood.content}</span><br> 
<b> 发 表 时 间 : </b> 
<span as= publa ss 上 timeu> 
${mood.publishTime} 
</span><br> 
<Db> 点 睦 数 :， </b><span id="praise num">$ {mood.praiseNum}</span><br> 
<div style="margin-left: 350px"> 
<%-- ”传统 点 赞 请 求 --> 
<%--<a id="praise" href="/mood/$ {mood.id}/praise?userId= 
${mood.userId}"> 赞 </a>--%$> 
<g-- 引入 redis 缓存 的 点 赞 请 求 --> 
<a id="praise" href="/mood/$ {mood.id}/praiseForRedis?userId= 
${mood.userId}"> 赞 </a> 
</div> 
</c:forEach> 
< 
</body> 
Soor lt ></ASCr LD 
</html> 


12.3.6 ”集成 Quartz 定时 器 


Quartz 是 一 个 完全 由 Java 编写 的 开源 任务 调度 的 框架 ， 通 过 触发 器 设置 作业 定时 运行 规 
则 ， 控 制作 业 的 运行 时 间 。Quartz 定时 器 作用 很 多 ， 比 如 ， 定 时 发 送信 息 和 定时 生成 报表 等 。 

Quartz 框架 主要 核心 组 件 包括 调度 器 、 触 发 器 和 作业 。 调 度 器 作为 作业 的 总 指挥 ， 触 发 器 
作为 作业 的 操作 者 ， 作 业 为 应 用 的 功能 模块 。 其 关系 如 图 12-19 所 示 。 


JobDetail Trigger 


Scheduler 


图 12-19 ”Quartz 各 个 组 件 的 关系 


Job 是 一 个 接口 ， 该 接口 只 有 一 个 方法 execute， 被 调度 的 作业 (类 ) 需 实现 该 接口 中 execute() 
方法 ，JobExecutionContext 类 提供 了 调度 上 下 文 的 各 种 信息 。 每 次 执行 该 Job 均 重 新 创建 一 个 
Job 实例 。Job 的 源码 如 下 : 
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public interface Job { 


} 


Spring MVC + MyBatis 快速 开发 与 项 目 实 战 


void execute (JobExecutionContext varl) throws JobExecutionException; 


Quartz 在 每 次 执行 Job 时 ， 都 重新 创建 一 个 Job 实例 ， 所 以 它 不 直接 接受 一 个 Job 的 实例 ， 
相反 它 接收 一 个 Job 实现 类 ， 以 便 运行 时 通过 newInstanceO 的 反射 机 制 实例 化 Job。 因 此 需要 通 
过 一 个 类 来 描述 Job 的 实现 类 及 其 他 相关 的 静态 信息 ， 如 Job 名 字 、 描 述 、 关 联 监听 器 等 信息 ， 
JobDetail 承担 了 这 一 角色 。JobDetail 用 来 保存 作业 的 详细 信息 。 一 个 JobDetail 可 以 有 多 个 


Trigger， 但 是 一 个 Trigger 


只 能 


对 应 一 个 JobDetail 


Trigger 触发 器 描述 触发 Job 的 执行 规则 。 主 要 有 SimpleTrigger 和 CronTrigger 这 两 个 子 
类 。 当 仅 需 触发 一 次 或 者 以 固定 时 间 间 隔 周 期 执行 时 ，SimpleTrigger 是 最 适合 的 选择 ， 而 
CronTrigger 则 可 以 通过 Cron 表达 式 定 义 出 各 种 复杂 时 间 规 则 的 调度 方案 ， 如 每 早晨 9:00 执 
行 ， 周 一 、 周 三 、 周 五 下 午 5:00 执行 等 。Cron 表达 式 定义 如 下 : 


CronTrigger 配置 格式 : 


格式 : 


0 


CO IC DC I CY et CD I CN CO 


[ 秒 ] [分 ] 


RE 

L510 2 * 
TOO * < 2 
el 
0 
A 大 
7 
人 
OO 


007 


1S) 
下 5 


Dd 
ee] 
ly | 
UD 


44 
10 
10 


14 ? 3 WED 
ER 
Uo) re 

Te 2 


Col 


[小 时 ] 


[日 ] 


De OT 2002=2005 


6 让 3 


Ql 
sell dl le le 


[月 ] [ 周 ] [年 ] 
每 天 12 点 触发 
每 天 10 点 15 分 触发 
每 天 10 点 15 分 触发 
每 天 10 点 15 分 触发 
2005 年 每 天 10 点 15 分 触发 
每 天 下 午 的 2 点 到 2 点 59 分 每 分 触发 
每 天 下 午 的 2 点 到 2 点 59 分 ( 整 点 开始 ， 每 隔 5 分 触发 ) 
每 天 下 午 的 18 点 到 18 点 59 分 ( 整 点 开始 ， 每 隔 5 分 触发 ) 
每 天 下 午 的 2 点 到 2 点 05 分 每 分 触发 
3 月份 每 周三 下 午 的 2 点 10 分 和 2 点 44 分 触发 
从 周一 到 周 五 每 天 上 午 的 10 点 15 分 触发 
每 月 15 号 上 午 10 点 15 分 触发 
每 月 最 后 一 天 的 10 点 15 分 触发 
每 月 最 后 一 周 的 星期 五 的 10 点 15 分 触发 
从 2002 年 到 2005 年 每 月 最 后 一 周 的 星期 五 的 10 点 15 分 触发 
每 月 的 第 三 周 的 星期 五 开始 触发 
每 月 的 第 一 个 中 午 开始 每 隔 5 天 触发 一 次 
每 年 的 11 月 11 号 11 点 11 分 触发 (光棍 节 ) 


Scheduler 负责 管理 Quartz 的 运行 环境 ，Quartz 是 基于 多 线程 架构 的 ， 它 启动 的 时 候 会 初始 
化 一 套 线 程 ， 这 套 线程 会 用 来 执行 一 些 预 置 的 作业 。Trigger 和 JobDetail 可 以 注册 到 Scheduler 
中 ，Scheduler 可 以 将 Trigger 绑 定 到 某 一 JobDetail 中 ， 这 样 当 Trigger 触发 时 ， 对 应 的 Job 就 被 
执行 。Scheduler 拥有 一 个 SchedulerContext， 它 类 似 于 ServletContext， 保 存 着 Scheduler 上 下 文 
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信息 ，Job 和 Trigger 都 可 以 访问 SchedulerContext 内 的 信息 。Scheduler 使 用 一 个 线程 池 作 为 任 
务 运 行 的 基础 设施 ， 任 务 通过 共享 线程 池 中 的 线程 提高 运行 效率 。 

了 解 完 Quartz 定时 器 的 基本 原理 后 ， 在 src\main\java\com\ay\job 目录 下 创建 定时 器 类 
PraiseDataSaveDBJob.java， 有 具体 代 码 如 下 : 


/** 
* 描述 ， 定 时 器 
* @author Ay 
* Q@date 2018/1/6. 
¥/ 
QComponent 
@Configurable 
@EnableScheduling 
public class PraiseDataSaveDBJob { 
@Resource 
private RedisTemplate redisTemplate; 
private static final String PRATSE HASH KbY = 
"springmv.mybatis.boot.mood.id.1list.key"; 
QResource 
private UserMoodPraiseRelService userMoodPraiseRelService; 
@Resource 
private MoodService moodService; 


// 每 10 秒 执 行 一 次 ， 真 实 项 目 当中 ， 可 以 把 定时 器 的 执行 计划 时 间 设 置 长 一 点 
// 比 如 说 每 天 晚上 凌晨 2 点 跑 一 次 

GSsehesuleql(erem 0 

public void savePraiseDataToDB2 () { 


//stepl: 在 redis 缓存 中 所 有 所 有 被 点 赞 的 说 说 id 
Set<String> moods = redisTemplate.opsForSet().members 
(PRRAISE HASH KEY); 
if(CollectionUtils.isEmpty (moods))t{ 
return, 
} 
for(String moodId: moods)!{ 
if(redisTemplate.opsForSet () .members (moodId) == null) 1{ 
continue; 
}else { 
//step2: 从 Redis 缓存 中 ， 通 过 说 说 id 获取 所 有 点 赞 的 用 户 id 列表 
Set<String> userIds = redisTemplate.opsForSet () .members 
(moodId) ， 
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if(CollectionUtils.isEmpty(userIds))t{ 
continue; 
}elsef 
//step3: 循环 保存 mood id 和 user id 的 关联 关系 到 MySQL 数据 库 
for(String userId:userIds)!{ 


UserMoodPraiseRel userMoodPraiseRel 
new UserMoodPraiseRel ();} 


userMoodPraiseRel.setMoodId (moodId)，; 
userMoodPraiseRel.setUserId (userId); 
// 保 存 说 说 与 用 户 的 关联 关系 


userMoodPraiseRelService.save (userMoodPraiseRel),; 


} 
Mood mood = moodService.findById (moodId); 


//step4: 更 新 说 说 点 赞 数 量 
// 说 说 的 总 点 赞 数量 = Redis 点 赞 数 量 + 数据 库 的 点 赞 数量 


mood.setPraiseNum(mood.getPraiseNum() + 
redisTemplate.opsForSet().size(moodId) .intValue ()); 


moodService.update (mood); 
//step5 :清除 Redis 缓存 中 的 数据 


redisTemplate.delete (mood1d); 


} 


} 
//step6: 清除 Redis 缓存 中 的 数据 


redisTemplate.delete (PRAISE HASH KEY) ， 


} 

e @Configurable: 加 上 此 注解 的 类 相当 于 XML 配置 文件 ， 可 以 被 Spring 扫描 初始 化 。 

e @EnableScheduling: 通过 在 配置 类 注解 @EnableScheduling 来 开启 对 计划 任务 的 支 

持 ， 然 后 在 要 执行 计划 任务 的 方法 上 注解 @Scheduled， 上 声明 这 是 一 个 计划 任务 。 

e @Scheduled: 注解 为 定时 任务 ，cron 表 达 式 里 写 执行 的 时 机 。 

使 用 Quartz 定时 器 有 两 种 方式 ;一 是 XML 配置 ;二 是 注解 方式 。 本 书 使 用 注解 的 方式 开 
发 代码 。 在 定时 器 类 PraiseDataSaveDBJob 中 ， 定 义 了 savePraiseDataToDB2() 方 法 ， 该 方法 通过 
@Scheduled 注解 定义 了 方法 的 执行 计划 : 每 10 秒 执行 一 次 ， 当 然 这 样 的 配置 只 是 方便 测试 ， 
在 真实 项 目 当 中 ， 可 以 把 定时 器 的 执行 计划 时 间 设 置 晚 一 点 ， 比 如 每 天 晚上 凌晨 2 点 开始 执 
行 。savePraiseDataToDB2() 方 法 的 逻辑 相对 比较 简单 ， 有 具体 说 明 如 下 : 


(1) 从 Redis 缓存 中 获取 所 有 被 点 赞 的 mood id。 
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(2) 通过 mood id 从 Redis 缓存 中 获取 所 有 点 赞 的 user id 列表 。 
(3) 循环 保存 mood id 和 user id 的 关联 关系 到 MySQL 数据 库 。 


(4) 更 新 说 说 的 点 赞 数量 。 
(5) 清除 Redis 缓存 中 的 数据 。 


12.3.7 ”测试 


所 有 的 代码 开发 完成 之 后 ， 重 新 启动 项 目 springmvc-mybatis-book， 在 浏览 器 中 输入 访问 
URL: http:Wlocalhost:8080/mood/findAll， 查 询 所 有 的 说 说 列表 ， 不 断 地 单 击 第 一 条 说 说 的 赞 功 
能 ， 便 可 以 看 到 第 一 条 说 说 的 点 赞 数量 不 断 增 加 ， 同 时 查看 MySQL 数据 库 表 mood 和 
user mood praise rel ， 可 以 看 到 mood 表 的 praise num 的 点 赞 数量 不 断 被 更 新 ， 而 
user mood praise rel 表 中 mood id 和 user id 的 关联 关系 数据 每 隔 10s 也 会 被 保存 到 表 中 。 有 具体 


如 图 12-20 和 图 12-21 所 示 。 


content 


次 门 真美 ， 么 么 改 ! 


userid publish time praise rium 


1 
2 


2018.05-30 22:09:05 126 


2018-07-29 EE pd 99 


图 12-20 mood 表 的 praise_num 的 点 赞 数量 不 断 被 更 新 


, 
28 36 
29 43 


30 38 


31 66 
32 54 
33 82 
34 42 


user id 


mood id 


1 
1 
1 
1 
1 
1 


图 12-21 mood id 和 user id 的 关联 关系 数据 


12.4 集成 ActiveMQ 


12.4.1 概述 


前 文 ， 已 经 总 结 了 传统 的 点 赞 功能 实现 所 暴露 的 问题 ， 主 要 有 以 下 几 点 : 
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(1) 高 并 发 请 求 下 ， 服 务 器 频繁 创建 线程 。 

(2) 高 并 发 请 求 下 ， 数 据 库 连 接 池 中 的 连接 数 有 限 。 

(3) 高 并 发 请 求 下 ， 点 赞 功能 是 同步 处 理 等 。 

我 们 通过 引入 Redis 缓存 避免 高 并 发 写 数据 库 而 造成 数据 库 压 力 ， 同 时 引入 Redis 缓存 提高 
读 的 性 能 ， 基 本 可 以 解决 问题 2) ， 本 节 我 们 主要 针对 问题 “3) 提供 解决 方案 ， 有 具体 如 图 12-22 
所 示 。 


Service 屋 

A l 

1 ! 

| 

| se | 

= | | 保存 说 说 点 赞 记录 到 | ma | 
CI pd | 

| 

| | 王 和 oh 
| 异步 处 理 
Bam ee ee a ee te am mm mm wo J 


Quartz 定 时 种 


更 新 说 说 点 鞠 数 量 


MySQL 数据 库 i 


图 12-22 ”高 并 发 点 赞 项 目 解决 方案 


为 了 解决 高 并 发 请 求 下 ， 点 赞 功能 同步 处 理 所 带 来 的 服务 器 压力 (Redis 缓存 的 压力 或 数据 
库 压 力 等 ) ， 我 们 引入 MQ 消息 中 间 件 进行 异步 处 理 ， 用 户 每 次 点 赞 都 会 推送 消息 到 MQ 服务 
器 并 及 时 返回 ， 这 样 用 户 的 点 赞 请 求 就 及 时 结束 ， 避 免 了 点 赞 请 求 线程 占用 时 间 长 的 问题 。 与 
此 同时 ，MQ 消息 中 间 件 接收 到 消息 后 ， 会 按照 “自己 的 方式 ”及 时 消费 ， 还 可 以 用 MQ 消息 
中 间 件 来 限制 流量 并 进行 异步 处 理 等 。 


保存 说 说 点 赞 记录 


12.4.2 ”ActiveMQ 的 安装 


MQ 英文 名 是 MessageQueue， 中 文 名 是 消息 队列 ， 是 一 个 消息 的 接受 和 转发 的 容器 ， 可 用 
于 消息 推送 。ActiveMQ 是 Apache 提供 的 一 个 开源 的 消息 系统 ， 完 全 采用 Java 来 实现 ， 因 此 ， 
它 能 很 好 地 支持 J]2EE 提出 的 JMS (Java Message Service， 即 Java 消息 服务 ) 规范 。 
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安装 ActiveMQ 之 前 ， 我 们 需要 到 官网 (http://activemq.apache.org/activemq-5150-release.html) 
下 载 ， 本 书 使 用 apache-activemq-5.15.0 这 个 版 本 进行 讲解 。ActiveMQ 有 具体 安装 步骤 如 下 : 


将 官网 下 载 的 安装 包 apache-activemq-5.15.0-bin.zip 解压 。 

EXIZ 打开 解压 的 文件 夹 ， 进 入 bin 目录 ， 根 据 电脑 操作 系统 是 32 位 还 是 64 位 ， 选 择 
进入 【win32】 文件 夹 或 者 【win64】 文 件 夹 。 

03 双击 【activemq.bat]， 即 可 启动 ActiveMQ， 如 图 12-23 所 示 。 当 看 到 如 图 12-24 
所 示 的 启动 信息 时 ， 代 表 ActiveMQ 安装 成 功 。 从 图 中 可 以 看 出 ，ActiveMQ 默认 启动 到 8161 
端口 。 


Sk 


3 activemq.bat 

(3 InstallService.bat 
3 UninstallService.bat 
了 wrapper.conf 


2 wrapper.dll 


Nm wrapper.exe 


图 12-23 ”ActiveMQ 安装 界面 


图 12-24 ”ActiveMQ 启动 成 功 界 面 
04 安装 成 功 之 后 , 在 浏览 器 中 输入 http://localhost:8161/admin 链接 访问 , 第 一 次 访问 


需要 输入 用 户 名 admin 和 密码 admin 进行 登录 ， 登 录 成 功 之 后 ， 就 可 以 看 到 ActiveMQ 的 首页 ， 
具体 如 图 12-25 所 示 。 
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ActiveM0 


Home | Queues | Topics | Subscribers | Connections | Network | Scheduted | Send 


Welcome! 


Weicome to the Apache ActiveMQ Console of localhost GD:DESKTOP-9RV1IB]-51478-1511882105912-0:1) 


You can find more information about Apache ActiveMQ on the Apache ActiveMQ Site 


Broker 


Name iocalhost 


Version 5.15.0 


ID ID:DESKTOP-9RV118)]-51478-1511882105912-0:1 


Uptime 16 minytes 
Store percent used 0 
Memory percent used 0 


Temp percent used 0 


Copyright 2005-2015 The Apache Software Foundation. 


图 12-25 ActiveMQ 首页 


12.4.3 ”集成 ActiveMQ 


在 SSM 框架 中 集成 ActiveMQ 缓存 ， 首 先 需要 在 pom.xml 文件 中 引入 所 需 的 依赖 ， 具 体 代 


人 码 如 下 : 


xl active mq start > 
<dependency> 


<groupld>org.springframework</groupIid> 


<artifactId>spring-jms</artifactId> 


<version>${spring.version}</version> 


</dependency> 
<dependency> 


<grouplId>org.apache.activemq</groupId> 
<artifactlid>activemq-all</artifactId> 


<version>5.11.2</version> 
<exclusions> 
<exclusion> 


<artifactIid>spring-context</artifactId> 
<grouplId>org.springframework</groupId> 


</exclusion> 
<exclusion> 


<groupld>org.apache.geronimo.specs</groupId> 
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<artifactId>geronimo-jms 1.1 spec</artifactId> 
</exclusion> 
</exclusions> 
</dependency> 
<dependency> 
<groupId>javax.jms</groupId> 
<artifactId>javax.jms-api</artifactId> 
<version>2.0.1</version> 
</dependency> 
< “actlive mq end 二 一 > 


依赖 添加 完成 之 后 ， 需 要 在 \src\main\resources 目录 下 创建 Active MQ 配置 文件 
spring-jms.xml， 具 体 代码 如 下 : 


<?xml Version="1.0" encoding="UTF-8"?> 
<beans xmlns:xsi="http://www.w3.o0rg/2001/XMLSchema-instance" 
xmlns="http://www.springframework.org/schema/beans" 
xmlns:context="http://www.springframework.org/schema/context" 
xmlns:jms="http://www.springframework.org/schema/jms" 
xsi:schemaLocation="http://www.springframework.org/schema/beans 
http://www.springframework.org/schema/beans/spring-beans-4.0.xsd 
http://www.springframework.org/schema/context 
http://www.springframework.org/schema/context/ 
spring-context-4.0.xsd 
http://www.springframework.org/schema/jms 
http://www.springframework.org/schema/jms/ 
spring-jms-4.0.xsd"> 
<bean id="connectionFactory" 
class="org.springframework.jms.connection. 
CachingConnectionFactory"> 
<description>JMS 连接 工厂 </description> 
<property name="targetConnectionFactory"> 
<bean class="org.apache.activemq.spring. 
ActiveMQOConnectionFactory"> 
<property name="brokerURL" value="${activemg url} " /> 
<property name="userName" value="${activemq username}" /> 
<property name="password" value="${activemq password}" /> 
</bean> 
</property> 
<property name="sessionCacheSize" value="100" /> 


</bean> 
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<!-- Spring JmsTemplate 的 消息 生产 者 start--> 
<bean id="jmsTemplate'" class= 
"org.springframework.jms.core.JmsTemplate"> 

<description> 队 列 模式 模型 </description> 
<constructor-arg ref="connectionFactory" /> 
<property name="receiveTimeout" value="10000" /> 
<1-- 如 果 为 True， 则 是 Topic; 如 果 是 false 或 者 默认 ， 则 是 queue --> 
<property name="pubSubDomain" value="false" /> 

</bean> 


<!-- 消息 消费 者 start--> 

<!-- 定义 Queue 监听 器 --> 

<jms:listener-container destination-type="queue" 
container-type="default" connection-factory= 
"connectionFactory" acknowledge="auto"> 

<!-- 可 写 多 个 监听 器 --> 

<jms:listener destination="ay.queue.high.concurrency.praise" 

ref= "moodConsumer™" /> 
</jms:listener-container> 
<!-- 消息 消费 者 end --> 


</beans> 


在 配置 文件 spring-jms.xml 中 ， 首 先 定义 了 ActiveMQ 的 连接 信息 ， 然 后 定义 了 
JmsTemplate 工具 类 ， 该 工具 类 是 Spring 框架 提供 的 ， 利 用 JmsTemplate 可 以 很 方便 地 发 送 和 接 
收 消 息 。 最 后 ， 我 们 定义 消费 者 类 moodConsumer ， 同 时 消费 者 监听 的 是 
ay.queue.high.concurrency.praise 这 个 topic， 当 有 生产 者 Producer 往 该 队列 推送 消息 时 ， 消 费 者 
Consumer 就 可 以 监听 到 该 消息 ， 并 做 相应 的 逻辑 处 理 。 

在 \src\main\resources 目录 下 创建 配置 文件 activemq.properties， 具 体 代 码 如 下 : 

### active mq 服务 器 地 址 

activemgq url=tcp://localhost:61616 

### 服务 器 用 户 名 

activemq username=admin 

### 服务 器 密码 

activemq password=admin 

activemq.properties 属性 文件 主要 配置 ActiveMQ 的 连接 信息 ， 供 spring-jms.xml 配 置 文件 使 用 。 

spring-jms.xml 开发 完成 之 后 ， 在 applicationContext.xml 配置 文件 中 使 用 <import> 标 签 引入 
入 spring-jms.xml 配置 文件 ， 有 具体 代码 如 下 : 


<import resource="spring-jms.xml"/> 
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12.4.4 ActiveMQ 异步 消费 


上 一 节 ， 已 经 在 项 目 中 集成 了 ActiveMQ 消息 中 间 件 ， 同 时 开发 了 相关 的 配置 文件 ， 这 一 
节 主 要 利用 ActiveMQ 实现 点 赞 功能 的 异步 处 理 。 有 具体 步骤 如 下 : 

首先 ， 在 srcwmainNjavavcomvay\mq 目录 下 创建 生产 者 类 MoodProducer， 有 具体 代码 如 下 : 

/** 

* 生产 者 jmsTemplate 

* @author Ay 

* @date 2017/11/30 

人 

@Component 
public class MoodProducer { 


@Resource 
private JmsTemplate jmsTemplate; 


private Logger 1og = Logger.getLogger (this.getClass()); 


public void sendMessage (Destination destination, final MoodDTO mood) { 
// 记 录 日 志 
log.info ("生产 者 --->>> 用 户 id: " + mood.getUserId() + " 给 说 说 id: " + 
mood.getIid() + " 点 赞 ")， 
//mood 实体 需要 实现 Serializable 序列 化 接口 


jmsTemplate.convertAndSend (destination, mood); 


} 


MoodProducer 类 提供 sendMessage 方 法 用 来 发 送 消 息 ， 方 法 的 第 一 个 参数 是 destination， 主 
要 用 来 指定 队列 的 名 称 ， 第 二 个 参数 是 mood 说 说 实体 。 通 过 调用 jmsTemplate 工具 类 的 
convertAndSend 方法 发 送 消息 。 需 要 注意 的 是 ，MoodDTO 说 说 实体 需要 实现 序列 化 接口 
Serializable， 具 体 代码 如 下 : 


/** 

* 描述 : 说 说 

“wereated By AV on 01 /ONLGs 

a/ 

public class MoodDTO implements Serializable{ 
// 省 略 代 码 
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其 次 ， 在 src\main\java\com\ay\mq 目录 下 创建 消费 者 类 MoodConsumer。 


/** 

* 消费 者 

* Qauthor Ay 

* @date 2017/11/30 

wi 

QComponent 

public class MoodConsumer implements MessageListener { 


private static final String PRAISE HASH KEY = 
"springmv .mybatis.boot.mood.id.list.key"; 


private Logger 1og = Logger.getLogger (this.getClass())， 


@Resource 
private RedisTemplate redisTemplate; 


public void onMessage (Message message) { 
tryt{ 
// 从 message 对 象 中 获取 说 说 实体 
MoodDTO moodDTO = (MoodDTO) ( (ActiveMQObjectMessage) 
message) .getObject () ; 
//1 .存放 到 set 中 
redisTemplate.opsForSet () .add (PRAISE HASH KEY ， 
moodDTO .getId()); 
//2 .存放 到 set 中 
redisTemplate.opsForSet() .add (moodDTO.getId(), 
moodDTO.getUserId())，; 
log .info ("消费 者 --->>> 用 户 id: "+ mood.getUserId() + " 给 说 说 id:"+ 
mood.getId() + " 点 赞 ")， 
}catch (Exception e)f{ 
System.out .Println(e) ， 


} 


消费 者 类 MoodConsumer 实现 MessageListener 接口 ， 完 成 对 消息 的 监听 和 接收 。 消 息 有 两 
种 接收 方式 同步 接收 和 异步 接收 。 


pe | 
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@ 同步 接收 : 主线 程 阻 塞 式 等 待 下 一 个 消息 的 到 来 ， 可 以 设置 timeout， 超 时 则 返回 null。 
e 异步 接收 : 主线 程 设置 MessageListener， 然 后 继续 做 自己 的 事 ， 子 线程 负责 监听 。 


同步 接收 又 称 为 阻塞 式 接 收 ， 蜡 步 接收 又 称 为 事件 驱动 的 接收 。 同 步 接收 ， 是 在 获取 
MessageConsumer 实例 之 后 ， 调 用 以 下 的 API: 
ereceive() 获取 下 一 个 消息 。 该 调用 将 导致 无 限期 的 阻塞 ， 直 到 有 新 的 消息 产生 。 
e receive(long timeout) 获取 下 一 个 消息 。 该 调用 可 能 导致 一 段 时 间 的 阻塞 ， 直 到 超时 
或 者 有 新 的 消息 产生 。 超 时 则 返回 null。 
e receiveNoWait() 获取 下 一 个 消息 。 这 个 调用 不 会 导致 阻塞 ， 如 果 没 有 下 一 个 消息 ， 
直接 返回 null。 


异步 接收 ， 是 在 获取 MessageConsumer 实例 之 后 ， 调 用 下 面 的 API; 


e setMessageListener(MessageListener) 设置 消息 监听 器 。MessageListener 是 一 个 接 
口 ， 只 定义 了 一 个 方法 ， 即 onMessage(Message message) 回 调 方 法 ， 当 有 新 的 消息 产生 
时 ， 该 方法 会 被 自动 调用 。 


可 见 ， 为 实现 异步 接收 ， 只 需要 对 MessageListener 进行 实现 ， 然 后 设置 为 Consumer 实例 


的 messageListener 即 可 。 
最 后 ， 修 改 MoodServiveImpl 类 中 的 praiseMoodForRedis() 方 法 ， 将 其 改 成 异步 处 理 方式 ， 


具体 代码 如 下 : 


/** 

* 描述 : 说 说 服务 类 

x @author Ay 

* @date 2018/1/6. 

Wf 

@Service 

public class MoodServiveImpl implements MoodService 1 


@Resource 

private MoodProducer moodProducer; 
QResource 

private RedisTemplate redisTemplate; 


// 队 列 
private static Destination aestination = 


new ActiveMOoueue ("ay.gqueue.high.concurrency.praise"); 


public boolean praiseMoodEorRedis (String userld, String moodId) { 
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// 修 改 为 异步 处 理 方式 

MoodDTO moodDTO = new MoodDTO(); 
moodDTO.setUserlid (user1Td); 
moodDTO.setId (moodId); 

// 发 送 消 息 


moodProducer.sendMessage (destination, moodDTO); 


//1 .存放 到 hashset 中 
redisTemplate.opsForSet() .add (PRAITSE HASH KEY , moodId); 
//2 .存放 到 set 中 

redisTemplate.opsForSet() .add (moodId,userId); 

return false; 


测 斌 


途 或 交流 学 习 使 


代码 开发 完成 之 后 ， 重 新 启动 项 目 springmvc-mybatis-book， 在 浏览 器 中 输入 请 求 URL: 
http://localhost:8080/mood/findAll， 给 某 条 说 说 点 赞 ， 如 果 在 控制 台 看 到 如 图 12-26 和 图 12-27 所 


示 的 信息 ， 


代表 使 用 MQ 异步 消费 开发 成 功 。 


DEBUG DispatcherServlet:979 - Last-Modified value for [/mood/ 
:1531660218776 
INFO MoodProducer:26 - 生产 者--->>> 用 户 id: 67 给 说 说 id: 1 点 装 


DEBUG JmsTemplate:502 - Executing callback on JMS Session: Cad 
DEBUG JmsTemplate:60€6 - Sending created message: ActiveMQObjed 
DEBUG DefaultMessageListenerContainer:306 - Received message d 


图 12-26 生产 者 打印 信息 


FRedisConnecti tils:125 ~ Opening RedisConnection 
DEBUG spre Closing Redis Connection 
INFO MoodConsumer:36 - 消费 者 ---~>>> 用 户 14d: 77 给 说 说 id: 1 点 攀 
DEBUG SqlSessionUtils:97 - Creating a new SqlSession 


DEBUG SqlSessionUtils:148 - SqlSession [org.apache.ibatis.ses 
DataSourceUtils:114 ~ Fetching JDBC Connection from Dat 


图 12-27 消费 者 打印 信息 
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一 步 一 步 学 
Spring Boot2 
{ 汪 微服 务 项 目 实战 


He 


本 书 以 项 目 实战 为 主线 ， 循 序 渐进 地 介绍 了 Spring 
Boot 2.0 整 合 众 多 流行 技术 及 在 Web 应 用 开发 方 
面 的 各 项 技能 。 第 1 章 由 零 开 始 引导 读者 快速 搭建 
Spring Boot 开 发 环境 。 第 2 章 、 第 3 章 、 第 10 章 和 
第 13 章 介绍 Spring Boot 数 据 访 问 应 用 。 第 4 章 至 
第 6 章 重点 介绍 Spring Boot 集 成 Thymeleaf 模 板 
引擎 、 事 务 使 用 以 及 拦截 器 和 监听 器 的 应 用 。 第 
7 章 至 第 9 章 主要 介绍 Spring Boot 使 用 Redis 缓 
存 和 Quartz 定 时 器 、 集 成 Log4j 日 志 框 架 和 发 
送 Email 邮件 。 第 11、12 章 主要 介绍 Spring Boot 
集成 ActiveMQ 和 异步 调用 、 全 局 异常 使 用 。 第 
14、15 章 主要 介绍 Spring Boot 应 用 监控 和 应 用 安 
全 Security。 第 16、17 章 介绍 Spring boot 微 服务 
在 Zookeeper 注 册 和 Dubbo 的 使 用 、 多 环境 配置 
和 使 用 以 及 在 Tomcat 上 的 部 署 应 用 。 第 18 章 主要 
探索 Spring Boot 背 后 的 原理 和 执行 流程 。 

本 书 适合 java 开 发 人 员 、Spring Boot 开 发 人 员 以 
及 计算 机 专业 的 学 生 使 用 。 
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